Skip to main content
IBM Quantum Platform

分析

アナリティクス・フィルターの取得

アナリティクス・フィルターの取得

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上の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: 2026-04-15'

出力

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"
    }
  ]
}

利用状況分析

利用状況分析

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上の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"]
コード・サンプル
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: 2026-04-15'

出力

HTTP応答状況コード
状況コード
説明
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
}

グループ化された利用状況分析

グループ化された利用状況分析

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上の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"]
コード・サンプル
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: 2026-04-15'

出力

HTTP応答状況コード
状況コード
説明
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
    }
  ]
}

日付でグループ化された利用状況分析を取得

日付でグループ化された利用状況分析を取得

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上の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"]
コード・サンプル
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: 2026-04-15'

出力

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,
      "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
    }
  ]
}
このページは役に立ちましたか？
バグや誤字の報告、またはコンテンツの要求はGitHubで行ってください。