Skip to main content
IBM Quantum Platform

분석

분석 필터 가져오기

분석 필터 가져오기

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 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::"
코드 샘플
GET
/v1/analytics/filters

인스턴스가 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
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"
    }
  ]
}

사용량 분석 받기

사용량 분석 받기

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 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"]
function_name
string[]

필터링할 함수 이름. 이 필터가 활성화되어 있으면 함수와 연결되지 않은 작업 및 세션은 제외됩니다.

예: ["sampler"]
코드 샘플
GET
/v1/analytics/usage

인스턴스가 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
200
401권한 없음
403금지됨
404찾을 수 없음
500내부 서버 오류
응답
{
  "usage": 10,
  "usage_ru": 0.0002,
  "jobs": 10,
  "sessions": 10,
  "sessions_usage": 10,
  "sessions_usage_ru": 0.0002,
  "avg_sessions_usage": 10,
  "avg_sessions_usage_ru": 0.0002,
  "max_sessions_usage": 10,
  "max_sessions_usage_ru": 0.0002,
  "batch_sessions": 10,
  "batch_sessions_usage": 10,
  "batch_sessions_usage_ru": 0.0002,
  "avg_batch_sessions_usage": 10,
  "avg_batch_sessions_usage_ru": 0.0002,
  "max_batch_sessions_usage": 10,
  "max_batch_sessions_usage_ru": 0.0002,
  "dedicated_sessions": 10,
  "dedicated_sessions_usage": 10,
  "dedicated_sessions_usage_ru": 0.0002,
  "avg_dedicated_sessions_usage": 10,
  "avg_dedicated_sessions_usage_ru": 0.0002,
  "max_dedicated_sessions_usage": 10,
  "max_dedicated_sessions_usage_ru": 0.0002,
  "individual_jobs": 10,
  "individual_jobs_usage": 10,
  "individual_jobs_usage_ru": 0.0002,
  "avg_individual_jobs_usage": 10,
  "avg_individual_jobs_usage_ru": 0.0002,
  "max_individual_jobs_usage": 10,
  "max_individual_jobs_usage_ru": 0.0002,
  "queue_time": 10,
  "avg_queue_time": 10,
  "max_queue_time": 10,
  "functions": 10,
  "functions_usage_ru": 0.0002,
  "avg_functions_usage_ru": 0.0002,
  "max_functions_usage_ru": 0.0002,
  "functions_quantum_usage_ms": 10,
  "functions_quantum_usage_ru": 0.0002,
  "functions_classical_usage_ru": 0.0002,
  "functions_license_cost_ru": 0.0002
}

그룹화된 사용량 분석 보기

그룹화된 사용량 분석 보기

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.account-analytics-usage.read

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.account-analytics-usage.read

입력

쿼리 매개변수
이름, 유형
설명
group_by
필수
string

그룹 사용의 핵심

가능한 값: instancebackenduser_idplansubscription_idfunction_name
예: "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"]
function_name
string[]

필터링할 함수 이름. 이 필터가 활성화되어 있으면 함수와 연결되지 않은 작업 및 세션은 제외됩니다.

예: ["sampler"]
코드 샘플
GET
/v1/analytics/usage_grouped

인스턴스가 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
200
401권한 없음
403금지됨
404찾을 수 없음
500내부 서버 오류
응답
{
  "data": [
    {
      "key": "ibm-q/main/open",
      "usage": 10,
      "usage_ru": 0.0002,
      "jobs": 10,
      "sessions": 10,
      "sessions_usage": 10,
      "sessions_usage_ru": 0.0002,
      "avg_sessions_usage": 10,
      "avg_sessions_usage_ru": 0.0002,
      "max_sessions_usage": 10,
      "max_sessions_usage_ru": 0.0002,
      "batch_sessions": 10,
      "batch_sessions_usage": 10,
      "batch_sessions_usage_ru": 0.0002,
      "avg_batch_sessions_usage": 10,
      "avg_batch_sessions_usage_ru": 0.0002,
      "max_batch_sessions_usage": 10,
      "max_batch_sessions_usage_ru": 0.0002,
      "dedicated_sessions": 10,
      "dedicated_sessions_usage": 10,
      "dedicated_sessions_usage_ru": 0.0002,
      "avg_dedicated_sessions_usage": 10,
      "avg_dedicated_sessions_usage_ru": 0.0002,
      "max_dedicated_sessions_usage": 10,
      "max_dedicated_sessions_usage_ru": 0.0002,
      "individual_jobs": 10,
      "individual_jobs_usage": 10,
      "individual_jobs_usage_ru": 0.0002,
      "avg_individual_jobs_usage": 10,
      "avg_individual_jobs_usage_ru": 0.0002,
      "max_individual_jobs_usage": 10,
      "max_individual_jobs_usage_ru": 0.0002,
      "queue_time": 10,
      "avg_queue_time": 10,
      "max_queue_time": 10,
      "functions": 10,
      "functions_usage_ru": 0.0002,
      "avg_functions_usage_ru": 0.0002,
      "max_functions_usage_ru": 0.0002,
      "functions_quantum_usage_ms": 10,
      "functions_quantum_usage_ru": 0.0002,
      "functions_classical_usage_ru": 0.0002,
      "functions_license_cost_ru": 0.0002
    }
  ]
}

날짜별로 그룹화된 사용량 분석 보기

날짜별로 그룹화된 사용량 분석 보기

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.account-analytics-usage.read

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.account-analytics-usage.read

입력

쿼리 매개변수
이름, 유형
설명
group_by
필수
string

그룹 사용의 핵심

가능한 값: instancefunction_name
예: "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"]
function_name
string[]

필터링할 함수 이름. 이 필터가 활성화되어 있으면 함수와 연결되지 않은 작업 및 세션은 제외됩니다.

예: ["sampler"]
코드 샘플
GET
/v1/analytics/usage_grouped_by_date

인스턴스가 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
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,
      "usage_ru": 0.0002,
      "jobs": 10,
      "sessions": 10,
      "sessions_usage": 10,
      "sessions_usage_ru": 0.0002,
      "avg_sessions_usage": 10,
      "avg_sessions_usage_ru": 0.0002,
      "max_sessions_usage": 10,
      "max_sessions_usage_ru": 0.0002,
      "batch_sessions": 10,
      "batch_sessions_usage": 10,
      "batch_sessions_usage_ru": 0.0002,
      "avg_batch_sessions_usage": 10,
      "avg_batch_sessions_usage_ru": 0.0002,
      "max_batch_sessions_usage": 10,
      "max_batch_sessions_usage_ru": 0.0002,
      "dedicated_sessions": 10,
      "dedicated_sessions_usage": 10,
      "dedicated_sessions_usage_ru": 0.0002,
      "avg_dedicated_sessions_usage": 10,
      "avg_dedicated_sessions_usage_ru": 0.0002,
      "max_dedicated_sessions_usage": 10,
      "max_dedicated_sessions_usage_ru": 0.0002,
      "individual_jobs": 10,
      "individual_jobs_usage": 10,
      "individual_jobs_usage_ru": 0.0002,
      "avg_individual_jobs_usage": 10,
      "avg_individual_jobs_usage_ru": 0.0002,
      "max_individual_jobs_usage": 10,
      "max_individual_jobs_usage_ru": 0.0002,
      "queue_time": 10,
      "avg_queue_time": 10,
      "max_queue_time": 10,
      "functions": 10,
      "functions_usage_ru": 0.0002,
      "avg_functions_usage_ru": 0.0002,
      "max_functions_usage_ru": 0.0002,
      "functions_quantum_usage_ms": 10,
      "functions_quantum_usage_ru": 0.0002,
      "functions_classical_usage_ru": 0.0002,
      "functions_license_cost_ru": 0.0002
    }
  ]
}
이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.