분석
분석 필터 가져오기
분석 필터 가져오기
권한 부여
이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access
quantum-computing.account-analytics-filters.read
감사
이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.
quantum-computing.account-analytics-filters.read
입력
이름, 유형 | 설명 |
|---|---|
instance string[] | 예: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/analytics/filters
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/analytics/filters' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR-TOKEN' \
-H 'Service-CRN: YOUR-SERVICE-CRN' \
-H 'IBM-API-Version: 2024-01-01' 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/analytics/filters
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/analytics/filters",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 200 | |
| 401 | 권한 없음 |
| 403 | 금지됨 |
| 404 | 찾을 수 없음 |
| 500 | 내부 서버 오류 |
{
"backends": [
{
"name": "simulator"
}
],
"instances": [
{
"id": "crn:v1:staging:public:quantum-computing:region:a/account:",
"deleted": true
}
],
"users": [
{
"id": "123"
}
],
"plans": [
{
"name": "premium"
}
],
"subscriptions": [
{
"id": "7f666d17-7893-47d8-bf9d-2b2389fc4dfc",
"name": "premium"
}
]
}{
"type": "object",
"properties": {
"backends": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "simulator"
}
},
"required": [
"name"
]
}
},
"instances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "crn:v1:staging:public:quantum-computing:region:a/account:"
},
"deleted": {
"type": "boolean"
}
},
"required": [
"id",
"deleted"
]
}
},
"users": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "123"
}
},
"required": [
"id"
]
}
},
"plans": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "premium"
}
},
"required": [
"name"
]
}
},
"subscriptions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "7f666d17-7893-47d8-bf9d-2b2389fc4dfc"
},
"name": {
"type": "string",
"example": "premium"
}
},
"required": [
"id",
"name"
]
}
}
},
"required": [
"backends",
"instances",
"users",
"plans",
"subscriptions"
]
}사용량 분석 받기
사용량 분석 받기
권한 부여
이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access
quantum-computing.account-analytics-usage.read
감사
이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.
quantum-computing.account-analytics-usage.read
입력
이름, 유형 | 설명 |
|---|---|
instance string[] | 예: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | 예: "2024-01-01T00:00:00.000Z" |
interval_end string | 예: "2024-01-01T00:00:00.000Z" |
backend string[] | 예: "ibm_tenerife" |
user_id string[] | 예: "123" |
simulators boolean | 시뮬레이터 포함 기본값: true |
plan string[] | 예: "premium" |
subscription_id string[] | 분석 데이터를 요청하는 구독 ID. 단일 ID이거나 ID 배열일 수 있습니다. 예: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/analytics/usage
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/analytics/usage' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR-TOKEN' \
-H 'Service-CRN: YOUR-SERVICE-CRN' \
-H 'IBM-API-Version: 2024-01-01' 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/analytics/usage
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/analytics/usage",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 200 | |
| 401 | 권한 없음 |
| 403 | 금지됨 |
| 404 | 찾을 수 없음 |
| 500 | 내부 서버 오류 |
{
"usage": 10,
"jobs": 10,
"sessions": 10,
"sessions_usage": 10,
"avg_sessions_usage": 10,
"max_sessions_usage": 10,
"batch_sessions": 10,
"batch_sessions_usage": 10,
"avg_batch_sessions_usage": 10,
"max_batch_sessions_usage": 10,
"dedicated_sessions": 10,
"dedicated_sessions_usage": 10,
"avg_dedicated_sessions_usage": 10,
"max_dedicated_sessions_usage": 10,
"individual_jobs": 10,
"individual_jobs_usage": 10,
"avg_individual_jobs_usage": 10,
"max_individual_jobs_usage": 10,
"queue_time": 10,
"avg_queue_time": 10,
"max_queue_time": 10
}{
"type": "object",
"properties": {
"usage": {
"type": "number",
"example": 10,
"description": "총 사용량(밀리초 단위)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "총 작업 수"
},
"sessions": {
"type": "number",
"example": 10,
"description": "총 세션 수"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "총 세션 사용량(밀리초 단위)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 세션 사용량(밀리초 단위)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 세션 사용량(밀리초 단위)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "총 배치 세션 수"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "총 배치 세션 사용량(밀리초 단위)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 배치 세션 사용량(밀리초 단위)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 배치 세션 사용량(밀리초)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "총 전용 세션 수"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "총 전용 세션 사용량(밀리초 단위)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 전용 세션 사용량(밀리초 단위)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 전용 세션 사용량(밀리초 단위)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "개별 작업의 총 개수"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "총 개별 작업 사용량(밀리초 단위)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "평균 개별 작업 사용량(밀리초 단위)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "개별 작업 최대 사용량(밀리초)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "총 대기열 시간(밀리초)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "평균 대기열 시간(밀리초)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "최대 대기열 시간(밀리초)"
}
},
"required": [
"usage",
"jobs",
"sessions",
"sessions_usage",
"avg_sessions_usage",
"max_sessions_usage",
"batch_sessions",
"batch_sessions_usage",
"avg_batch_sessions_usage",
"max_batch_sessions_usage",
"dedicated_sessions",
"dedicated_sessions_usage",
"avg_dedicated_sessions_usage",
"max_dedicated_sessions_usage",
"individual_jobs",
"individual_jobs_usage",
"avg_individual_jobs_usage",
"max_individual_jobs_usage",
"queue_time",
"avg_queue_time",
"max_queue_time"
]
}그룹화된 사용량 분석 보기
그룹화된 사용량 분석 보기
권한 부여
이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access
quantum-computing.account-analytics-usage.read
감사
이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.
quantum-computing.account-analytics-usage.read
입력
이름, 유형 | 설명 |
|---|---|
group_by 필수 string | 그룹 사용의 핵심 가능한 값: instancebackenduser_idplansubscription_id예: "instance" |
instance string[] | 예: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | 시작 날짜 예: "2024-01-01T00:00:00.000Z" |
interval_end string | 종료 날짜 예: "2024-01-01T00:00:00.000Z" |
backend string[] | 필터링할 백엔드 예: "ibm_tenerife" |
user_id string[] | 예: "123" |
simulators boolean | 시뮬레이터 포함 기본값: true |
plan string[] | 예: "premium" |
subscription_id string[] | 분석 데이터를 요청하는 구독 ID. 단일 ID이거나 ID 배열일 수 있습니다. 예: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/analytics/usage_grouped
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/analytics/usage_grouped' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR-TOKEN' \
-H 'Service-CRN: YOUR-SERVICE-CRN' \
-H 'IBM-API-Version: 2024-01-01' 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/analytics/usage_grouped
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/analytics/usage_grouped",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 200 | |
| 401 | 권한 없음 |
| 403 | 금지됨 |
| 404 | 찾을 수 없음 |
| 500 | 내부 서버 오류 |
{
"data": [
{
"key": "ibm-q/main/open",
"usage": 10,
"jobs": 10,
"sessions": 10,
"sessions_usage": 10,
"avg_sessions_usage": 10,
"max_sessions_usage": 10,
"batch_sessions": 10,
"batch_sessions_usage": 10,
"avg_batch_sessions_usage": 10,
"max_batch_sessions_usage": 10,
"dedicated_sessions": 10,
"dedicated_sessions_usage": 10,
"avg_dedicated_sessions_usage": 10,
"max_dedicated_sessions_usage": 10,
"individual_jobs": 10,
"individual_jobs_usage": 10,
"avg_individual_jobs_usage": 10,
"max_individual_jobs_usage": 10,
"queue_time": 10,
"avg_queue_time": 10,
"max_queue_time": 10
}
]
}{
"type": "object",
"properties": {
"data": {
"description": "데이터",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"example": "ibm-q/main/open",
"description": "그룹화 키",
"nullable": true
},
"usage": {
"type": "number",
"example": 10,
"description": "총 사용량(밀리초 단위)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "총 작업 수"
},
"sessions": {
"type": "number",
"example": 10,
"description": "총 세션 수"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "총 세션 사용량(밀리초 단위)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 세션 사용량(밀리초 단위)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 세션 사용량(밀리초 단위)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "총 배치 세션 수"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "총 배치 세션 사용량(밀리초 단위)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 배치 세션 사용량(밀리초 단위)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 배치 세션 사용량(밀리초)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "총 전용 세션 수"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "총 전용 세션 사용량(밀리초 단위)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 전용 세션 사용량(밀리초 단위)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 전용 세션 사용량(밀리초 단위)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "개별 작업의 총 개수"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "총 개별 작업 사용량(밀리초 단위)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "평균 개별 작업 사용량(밀리초 단위)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "개별 작업 최대 사용량(밀리초)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "총 대기열 시간(밀리초)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "평균 대기열 시간(밀리초)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "최대 대기열 시간(밀리초)"
}
},
"required": [
"key",
"usage",
"jobs",
"sessions",
"sessions_usage",
"avg_sessions_usage",
"max_sessions_usage",
"batch_sessions",
"batch_sessions_usage",
"avg_batch_sessions_usage",
"max_batch_sessions_usage",
"dedicated_sessions",
"dedicated_sessions_usage",
"avg_dedicated_sessions_usage",
"max_dedicated_sessions_usage",
"individual_jobs",
"individual_jobs_usage",
"avg_individual_jobs_usage",
"max_individual_jobs_usage",
"queue_time",
"avg_queue_time",
"max_queue_time"
]
}
}
},
"required": [
"data"
]
}날짜별로 그룹화된 사용량 분석 보기
날짜별로 그룹화된 사용량 분석 보기
권한 부여
이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access
quantum-computing.account-analytics-usage.read
감사
이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.
quantum-computing.account-analytics-usage.read
입력
이름, 유형 | 설명 |
|---|---|
group_by 필수 string | 그룹 사용의 핵심 가능한 값: instance예: "instance" |
instance string[] | 예: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | 예: "2024-01-01T00:00:00.000Z" |
interval_end string | 예: "2024-01-01T00:00:00.000Z" |
backend string[] | 예: "ibm_tenerife" |
user_id string[] | 예: "123" |
simulators boolean | 시뮬레이터 포함 기본값: true |
plan string[] | 예: "premium" |
subscription_id string[] | 분석 데이터를 요청하는 구독 ID. 단일 ID이거나 ID 배열일 수 있습니다. 예: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/analytics/usage_grouped_by_date
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/analytics/usage_grouped_by_date' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR-TOKEN' \
-H 'Service-CRN: YOUR-SERVICE-CRN' \
-H 'IBM-API-Version: 2024-01-01' 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/analytics/usage_grouped_by_date
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/analytics/usage_grouped_by_date",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 200 | |
| 400 | 잘못된 요청 |
| 401 | 권한 없음 |
| 403 | 금지됨 |
| 404 | 찾을 수 없음 |
| 500 | 내부 서버 오류 |
{
"interval_start": "2024-01-01T00:00:00.000Z",
"interval_end": "2024-01-01T00:00:00.000Z",
"data": [
{
"key": "ibm-q/open/main",
"interval_start": "2024-01-01T00:00:00.000Z",
"interval_end": "2024-01-01T00:00:00.000Z",
"usage": 10,
"jobs": 10,
"sessions": 10,
"sessions_usage": 10,
"avg_sessions_usage": 10,
"max_sessions_usage": 10,
"batch_sessions": 10,
"batch_sessions_usage": 10,
"avg_batch_sessions_usage": 10,
"max_batch_sessions_usage": 10,
"dedicated_sessions": 10,
"dedicated_sessions_usage": 10,
"avg_dedicated_sessions_usage": 10,
"max_dedicated_sessions_usage": 10,
"individual_jobs": 10,
"individual_jobs_usage": 10,
"avg_individual_jobs_usage": 10,
"max_individual_jobs_usage": 10,
"queue_time": 10,
"avg_queue_time": 10,
"max_queue_time": 10
}
]
}{
"type": "object",
"properties": {
"interval_start": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "간격 시작"
},
"interval_end": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "간격 종료"
},
"data": {
"description": "결과",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"example": "ibm-q/open/main",
"description": "그룹 키. groupBy 쿼리 매개변수에 따라 다릅니다."
},
"interval_start": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "간격 시작"
},
"interval_end": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "간격 종료"
},
"usage": {
"type": "number",
"example": 10,
"description": "총 사용량(밀리초 단위)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "총 작업 수"
},
"sessions": {
"type": "number",
"example": 10,
"description": "총 세션 수"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "총 세션 사용량(밀리초 단위)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 세션 사용량(밀리초 단위)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 세션 사용량(밀리초 단위)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "총 배치 세션 수"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "총 배치 세션 사용량(밀리초 단위)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 배치 세션 사용량(밀리초 단위)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 배치 세션 사용량(밀리초)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "총 전용 세션 수"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "총 전용 세션 사용량(밀리초 단위)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "평균 전용 세션 사용량(밀리초 단위)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "최대 전용 세션 사용량(밀리초 단위)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "개별 작업의 총 개수"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "총 개별 작업 사용량(밀리초 단위)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "평균 개별 작업 사용량(밀리초 단위)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "개별 작업 최대 사용량(밀리초)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "총 대기열 시간(밀리초)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "평균 대기열 시간(밀리초)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "최대 대기열 시간(밀리초)"
}
},
"required": [
"key",
"interval_start",
"interval_end",
"usage",
"jobs",
"sessions",
"sessions_usage",
"avg_sessions_usage",
"max_sessions_usage",
"batch_sessions",
"batch_sessions_usage",
"avg_batch_sessions_usage",
"max_batch_sessions_usage",
"dedicated_sessions",
"dedicated_sessions_usage",
"avg_dedicated_sessions_usage",
"max_dedicated_sessions_usage",
"individual_jobs",
"individual_jobs_usage",
"avg_individual_jobs_usage",
"max_individual_jobs_usage",
"queue_time",
"avg_queue_time",
"max_queue_time"
]
}
}
},
"required": [
"interval_start",
"interval_end",
"data"
]
}