Skip to main content
IBM Quantum Platform

ジョブ

ジョブの実行

Qiskit Runtime プリミティブを呼び出す。 返されたジョブIDに注意。 仕事のステータスを確認し、結果を確認するために使用します。 このリクエストのレートは、1ユーザーにつき毎分5ジョブまでに制限されています。

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.create

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.create

入力

本文パラメーター
名前、タイプ
説明
program_id
string

実行されるプログラムのID

backend
string

プログラムを実行するバックエンドを特定する名前。

runtime
string

プログラム実行時に使用する画像の名前とタグ（ IBM Quantum チャンネルユーザーのみ）。 name:tag "のパターンに従うこと。

tags
string[]

ジョブ・タグまたはプログラム・タグのリスト

log_level
string

プログラムのログレベル

使用可能な値: criticalerrorwarninginfodebug
cost
integer

ジョブが完了するまでの推定時間（秒単位）。 プログラム費用を超えないこと。 提供された値が最大値を超える場合、その値が上限となる。

最小値:: 0
最大値:: 10800
session_id
string

ジョブが属するセッションの識別子

calibration_id
string

ジョブに使用されたキャリブレーションのID

params
one of
SamplerV2 入力
object

SamplerV2 APIコールの入力

EstimatorV2 入力
object

EstimatorV2 APIコールの入力

NoiseLearner 入力
object

NoiseLearner APIコールの入力

実行ファイル ` v0.1 ` の入力
object

Executorプログラムの入力内容を記述したモデル。

実行ファイル ` v0.2 ` の入力
object

Executorプログラムの入力内容を記述したモデル。

執行者 v1.0 ParamsModel
object

Executorプログラムの入力内容を記述したモデル。

執行者 v1.1 ParamsModel
object

Executorプログラムの入力内容を記述したモデル。

NoiseLearnerV3 v0.1 入力
object

Noise Learner V3 プログラムの入力内容を説明するモデル。

NoiseLearnerV3 v0.2 入力
object

Noise Learner V3 プログラムの入力内容を説明するモデル。

NoiseLearnerV3 v0.3 ParamsModel
object

Noise Learner V3 プログラムの入力内容を説明するモデル。

private
boolean

trueに設定すると、入力パラメーターは返されず、結果は一度しか読み込めない。 ジョブ終了後、入力パラメータはサービスから削除される。 結果は読み込まれた後、サービスから削除される。 falseに設定すると、入力パラメータと結果はAPIの標準的な保持動作に従う。 値がtrueの場合のみレスポンスに返され、そうでない場合は省略される。

コード・サンプル
POST
/v1/jobs

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs

curl -X POST \
  'https://quantum.cloud.ibm.com/api/v1/jobs' \
  -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未検出
409使用量がインスタンス制限を超える
応答
{
  "id": "c5dge2d3rn7breq27i9g",
  "backend": "ibm_backend",
  "private": true
}

ジョブのリスト表示

実行した量子プログラムのジョブをリストアップしてください。

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.read

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.read

入力

照会パラメーター
名前、タイプ
説明
limit
integer

一度に返す結果の数。 提供された値が実行可能範囲外の場合、エラーは発生せず、代わりにデフォルト値が使用される。

デフォルト値: 200
最小値:: 1
最大値:: 200
offset
integer

ジョブのリストを取得する際にオフセットする結果の数。 提供された値が実行可能範囲外の場合、エラーは発生せず、代わりにデフォルト値が使用される。

デフォルト値: 0
最小値:: 0
最大値:: 2147483647
pending
boolean

trueの場合、'Queued'および'Running'ジョブを返す。 falseの場合は「Completed」、「Cancelled」、「Failed」ジョブを返す。

program
string

ジョブをフィルタリングするプログラムID

backend
string

ジョブをフィルタリングするバックエンド

created_after
string

フィルター後に作成されたジョブ

created_before
string

フィルター前に作成されたジョブ

sort
string

作成された時間順にASCまたはDESCでジョブを並べ替える (デフォルト)

tags
string[]

求人を絞り込むためのタグ

session_id
string

ジョブをフィルタリングするセッションID

exclude_params
boolean

ジョブパラメータをレスポンスから除外する

デフォルト値: true
コード・サンプル
GET
/v1/jobs

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs' \
  -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未検出
応答
{
  "jobs": [
    {
      "id": "c5dge2d3rn7breq27i9g",
      "backend": "ibmq_qasm_simulator",
      "cost": 0,
      "state": {
        "status": "Completed",
        "reason": ""
      },
      "status": "Completed",
      "params": {
        "iterations": 3
      },
      "program": {
        "id": "myprogram-abcdef12345"
      },
      "created": "2021-10-04T13:52:09.456851Z",
      "runtime": "ntc-provider-primitives:latest",
      "tags": [
        "tag1",
        "tag2",
        "tag3",
        "tag4"
      ],
      "session_id": "c5dge2d3rn7breq27i9g",
      "usage": {
        "qpu_charge_time_seconds": 20,
        "status": "complete"
      },
      "private": true,
      "estimated_running_time_seconds": 30.5,
      "calibration_id": "fez-ac-tls-test"
    },
    {
      "id": "c2gfe1m3ln7breq27i6e",
      "backend": "ibmq_qasm_simulator",
      "cost": 0,
      "state": {
        "status": "Completed",
        "reason": ""
      },
      "status": "Completed",
      "params": {
        "iterations": 3
      },
      "program": {
        "id": "myprogram-abcdef12345"
      },
      "created": "2021-10-05T13:52:09.456851Z",
      "runtime": "ntc-provider-primitives:latest",
      "tags": [
        "tag1",
        "tag2",
        "tag3",
        "tag4"
      ],
      "session_id": "c1mre2f3pn9breq18i4g"
    }
  ],
  "count": 2,
  "limit": 2,
  "offset": 0
}

仕事の詳細

指定した量子プログラムのジョブの詳細を一覧表示します。

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.read

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.read

入力

パス・パラメーター
名前、タイプ
説明
id
必須
string

既存のジョブの識別子

照会パラメーター
名前、タイプ
説明
exclude_params
boolean

ジョブパラメータをレスポンスから除外する

デフォルト値: false
コード・サンプル
GET
/v1/jobs/{id}

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}' \
  -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未検出
応答
{
  "id": "c5dge2d3rn7breq27i9g",
  "backend": "ibmq_qasm_simulator",
  "cost": 0,
  "state": {
    "status": "Completed",
    "reason": ""
  },
  "status": "Completed",
  "params": {
    "iterations": 3
  },
  "program": {
    "id": "myprogram-abcdef12345"
  },
  "created": "2021-10-04T13:52:09.456851Z",
  "runtime": "ntc-provider-primitives:latest",
  "tags": [
    "tag1",
    "tag2",
    "tag3",
    "tag4"
  ],
  "session_id": "c5dge2d3rn7breq27i9g",
  "private": true,
  "estimated_running_time_seconds": 30.5,
  "calibration_id": "fez-ac-tls-test"
}

ジョブの削除

指定されたジョブおよびその関連データを削除します。 仕事は末期状態でなければならない。

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.delete

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.delete

入力

パス・パラメーター
名前、タイプ
説明
id
必須
string

既存のジョブの識別子

コード・サンプル
DELETE
/v1/jobs/{id}

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}

curl -X DELETE \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2026-04-15'

出力

HTTP応答状況コード
状況コード
説明
204終了
400誤った要求
401認証されていません
403禁止
404未検出
500ジョブ削除の内部エラー
応答
終了

ジョブをキャンセルします

指定されたジョブをキャンセルします。

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.cancel

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.cancel

入力

パス・パラメーター
名前、タイプ
説明
id
必須
string

ジョブID

コード・サンプル
POST
/v1/jobs/{id}/cancel

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/cancel

curl -X POST \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/cancel' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2026-04-15'

出力

HTTP応答状況コード
状況コード
説明
204終了
400不正なキャンセル要求
401認証されていません
403禁止
404未検出
409仕事はキャンセルできない状態です。
500内部エラーによるジョブのキャンセル
応答
終了

ジョブ・ログの一覧

指定されたジョブのすべてのジョブログを一覧表示します。

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.read

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.read

入力

パス・パラメーター
名前、タイプ
説明
id
必須
string

ジョブID

コード・サンプル
GET
/v1/jobs/{id}/logs

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/logs

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/logs' \
  -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見つかりませんでした
応答
ジョブログを返します。

仕事の指標を得る

指定したジョブのメトリクスを取得します

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.read

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.read

入力

パス・パラメーター
名前、タイプ
説明
id
必須
string

ジョブID

コード・サンプル
GET
/v1/jobs/{id}/metrics

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/metrics

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/metrics' \
  -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未検出
応答
{
  "timestamps": {
    "created": "2026-03-06T14:02:11Z",
    "running": "2026-03-06T14:02:18Z",
    "finished": "2026-03-06T14:05:47Z"
  },
  "usage": {
    "qpu_charge_time_seconds": 20,
    "status": "complete"
  },
  "circuits_execution_time_ns": 20000000,
  "qiskit_version": "2.3.0"
}

求人結果一覧

このジョブの最終結果を返す。

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.read

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.read

入力

パス・パラメーター
名前、タイプ
説明
id
必須
string

ジョブID

コード・サンプル
GET
/v1/jobs/{id}/results

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/results

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/results' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2026-04-15'

出力

HTTP応答状況コード
状況コード
説明
200ジョブの最終結果を返します。
204ジョブの最終結果が見つからない。
400誤った要求
401認証されていません
403禁止
404未検出
応答
{
  "schema_version": "v0.1",
  "data": [
    {
      "results": {},
      "metadata": null
    }
  ],
  "metadata": {
    "chunk_timing": [
      {
        "start": "example",
        "stop": "example",
        "parts": [
          {
            "idx_item": 1,
            "size": 1
          }
        ]
      }
    ]
  }
}

ジョブ・タグの交換

ジョブ・タグの交換

許可

このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access

  • quantum-computing.job.update

監査

このメソッドを呼び出すと、以下の監査イベントが生成されます。

  • quantum-computing.job.update

入力

パス・パラメーター
名前、タイプ
説明
id
必須
string

ジョブID

本文パラメーター
名前、タイプ
説明
tags
必須
string[]

ジョブ・タグまたはプログラム・タグのリスト

コード・サンプル
PUT
/v1/jobs/{id}/tags

インスタンスが eu-de リージョンにある場合は、代わりにこちらの URL をご利用ください: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/tags

curl -X PUT \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/tags' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2026-04-15' \
  -H 'Content-Type: application/json' \
  -d '{"tags":["example"]}'

出力

HTTP応答状況コード
状況コード
説明
204終了
401認証されていません
403禁止
404未検出
応答
終了
このページは役に立ちましたか？
バグや誤字の報告、またはコンテンツの要求はGitHubで行ってください。