az quantum
Note
このリファレンスは、Azure CLI (バージョン 2.73.0 以降) の 量子 拡張機能の一部です。 拡張機能は、 az quantum コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。
このコマンド グループはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
Azure Quantum ワークスペースを管理し、Azure Quantum プロバイダーにジョブを送信します。
コマンド
| 名前 | 説明 | 型 | 状態 |
|---|---|---|---|
| az quantum execute |
Azure Quantum で実行するジョブを送信し、結果を待ちます。
|
Extension | Preview |
| az quantum job |
Azure Quantum のジョブを管理します。 |
Extension | Preview |
| az quantum job cancel |
完了していない場合は、Azure Quantum のジョブを取り消す要求。 |
Extension | Preview |
| az quantum job list |
Quantum ワークスペース内のジョブの一覧を取得します。 |
Extension | Preview |
| az quantum job output |
ジョブの実行結果を取得します。 |
Extension | Preview |
| az quantum job show |
ジョブの状態と詳細を取得します。 |
Extension | Preview |
| az quantum job submit |
Azure Quantum で実行するプログラムまたは回線を送信します。 |
Extension | Preview |
| az quantum job wait |
ジョブの実行が完了するまで、CLI を待機状態にします。 |
Extension | Preview |
| az quantum offerings |
Azure Quantum のプロバイダー オファリングを管理します。 |
Extension | Preview |
| az quantum offerings accept-terms |
プロバイダーと SKU の組み合わせの条件に同意して、ワークスペースの作成を有効にします。 |
Extension | Preview |
| az quantum offerings list |
特定の場所で使用可能なすべてのプロバイダー オファリングの一覧を取得します。 |
Extension | Preview |
| az quantum offerings show-terms |
プロバイダーと SKU の組み合わせの条件 (ライセンス URL や同意状態など) を表示します。 |
Extension | Preview |
| az quantum run |
Azure Quantum で実行するジョブを送信し、結果を待ちます。
|
Extension | Preview |
| az quantum target |
Azure Quantum ワークスペースのターゲットを管理します。 |
Extension | Preview |
| az quantum target clear |
既定の target-id をクリアします。 |
Extension | Preview |
| az quantum target list |
Azure Quantum ワークスペース内のプロバイダーとそのターゲットの一覧を取得します。 |
Extension | Preview |
| az quantum target set |
Azure Quantum にジョブを送信するときに使用する既定のターゲットを選択します。 |
Extension | Preview |
| az quantum target show |
Azure Quantum にジョブを送信するときに使用する現在の既定のターゲットのターゲット ID を取得します。 |
Extension | Preview |
| az quantum workspace |
Azure Quantum ワークスペースを管理します。 |
Extension | Preview |
| az quantum workspace clear |
既定の Azure Quantum ワークスペースをクリアします。 |
Extension | Preview |
| az quantum workspace create |
新しい Azure Quantum ワークスペースを作成します。 |
Extension | Preview |
| az quantum workspace delete |
指定された (または現在の) Azure Quantum ワークスペースを削除します。 |
Extension | Preview |
| az quantum workspace keys |
Azure Quantum Workspace API キーを管理します。 |
Extension | Preview |
| az quantum workspace keys list |
特定の (または現在の) Azure Quantum ワークスペースの API キーを一覧表示します。 |
Extension | Preview |
| az quantum workspace keys regenerate |
特定の (または現在の) Azure Quantum ワークスペースの API キーを再生成します。 |
Extension | Preview |
| az quantum workspace list |
使用可能な Azure Quantum ワークスペースの一覧を取得します。 |
Extension | Preview |
| az quantum workspace quotas |
特定の (または現在の) Azure Quantum ワークスペースのクォータを一覧表示します。 |
Extension | Preview |
| az quantum workspace set |
今後のコマンド用に既定の Azure Quantum ワークスペースを選択します。 |
Extension | Preview |
| az quantum workspace show |
指定された (または現在の) Azure Quantum ワークスペースの詳細を取得します。 |
Extension | Preview |
| az quantum workspace update |
指定された (または現在の) Azure Quantum ワークスペースを更新します。 |
Extension | Preview |
az quantum execute
コマンド グループ 'quantum' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
Azure Quantum で実行するジョブを送信し、結果を待ちます。
az quantum runに相当します。
az quantum execute --job-input-file
--job-input-format
--resource-group
--target-id
--workspace-name
[--entry-point]
[--job-name]
[--job-output-format]
[--job-params]
[--location]
[--shots]
[--storage]
[--target-capability]
[]
例
現在のフォルダー内のファイルから QIR ビットコードを実行し、結果を待ちます。
az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
--job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
--entry-point MyQirEntryPoint
リゲッティ シミュレーターで Quil パススルー ジョブを実行し、結果を待ちます。
az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation \
-t rigetti.sim.qvm --job-name MyJob --job-input-file MyProgram.quil \
--job-input-format rigetti.quil.v1 --job-output-format rigetti.quil-results.v1
ジョブ パラメーターを使用して IonQ シミュレーターに Qiskit 回線を送信し、結果を待ちます。
az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation \
-t ionq.simulator --job-name MyJobName --job-input-file MyCircuit.json \
--job-input-format ionq.circuit.v1 --job-output-format ionq.quantum-results.v1 \
--job-params count=100 content-type=application/json
必須のパラメーター
送信する入力ファイルの場所。
送信するファイルの形式。
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
量子コンピューティング ジョブの実行エンジン。 ワークスペースが一連のプロバイダーで構成されている場合、それぞれ 1 つ以上のターゲットが有効になります。
az quantum target setを使用して既定のターゲットを構成できます。
Quantum ワークスペースの名前。
az quantum workspace setを使用して既定のワークスペースを構成できます。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
QIR プログラムまたは回線のエントリ ポイント。 一部のプロバイダー QIR ジョブに必要です。
プログラムのこの実行に付けるフレンドリ名。
予想されるジョブ出力形式。
キーと値のペア、json 文字列、または json コンテンツを含む @{file} のリストとしてターゲットに渡されるジョブ パラメーター。
オプション '--location' は非推奨となり、2026 年 5 月に削除されます。
Location. 値のソース: az account list-locations
az configure --defaults location=<location>を使用して、既定の場所を構成できます。
指定されたターゲットでプログラムを実行する回数。
指定した場合、Azure Storage の ConnectionString を使用してジョブ データと結果が格納されます。
コンパイラに渡されるターゲット機能パラメーター。
Location. 値のソース: az account list-locations
az configure --defaults location=<location>を使用して、既定の場所を構成できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az quantum run
コマンド グループ 'quantum' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
Azure Quantum で実行するジョブを送信し、結果を待ちます。
az quantum executeに相当します。
az quantum run --job-input-file
--job-input-format
--resource-group
--target-id
--workspace-name
[--entry-point]
[--job-name]
[--job-output-format]
[--job-params]
[--location]
[--shots]
[--storage]
[--target-capability]
[]
例
現在のフォルダー内のファイルから QIR ビットコードを実行し、結果を待ちます。
az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
--job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
--entry-point MyQirEntryPoint
リゲッティ シミュレーターで Quil パススルー ジョブを実行し、結果を待ちます。
az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation \
-t rigetti.sim.qvm --job-name MyJob --job-input-file MyProgram.quil \
--job-input-format rigetti.quil.v1 --job-output-format rigetti.quil-results.v1
ジョブ パラメーターを使用して IonQ シミュレーターに Qiskit 回線を送信し、結果を待ちます。
az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation \
-t ionq.simulator --job-name MyJobName --job-input-file MyCircuit.json \
--job-input-format ionq.circuit.v1 --job-output-format ionq.quantum-results.v1 \
--job-params count=100 content-type=application/json
必須のパラメーター
送信する入力ファイルの場所。
送信するファイルの形式。
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
量子コンピューティング ジョブの実行エンジン。 ワークスペースが一連のプロバイダーで構成されている場合、それぞれ 1 つ以上のターゲットが有効になります。
az quantum target setを使用して既定のターゲットを構成できます。
Quantum ワークスペースの名前。
az quantum workspace setを使用して既定のワークスペースを構成できます。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
QIR プログラムまたは回線のエントリ ポイント。 一部のプロバイダー QIR ジョブに必要です。
プログラムのこの実行に付けるフレンドリ名。
予想されるジョブ出力形式。
キーと値のペア、json 文字列、または json コンテンツを含む @{file} のリストとしてターゲットに渡されるジョブ パラメーター。
オプション '--location' は非推奨となり、2026 年 5 月に削除されます。
Location. 値のソース: az account list-locations
az configure --defaults location=<location>を使用して、既定の場所を構成できます。
指定されたターゲットでプログラムを実行する回数。
指定した場合、Azure Storage の ConnectionString を使用してジョブ データと結果が格納されます。
コンパイラに渡されるターゲット機能パラメーター。
引数 '--location' は非推奨となり、2026 年 5 月に削除されます。
Location. 値のソース: az account list-locations
az configure --defaults location=<location>を使用して、既定の場所を構成できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |