az quantum

Note

このリファレンスは、Azure CLI (バージョン 2.73.0 以降) の quantum 拡張機能の一部です。 拡張機能は、 az quantum コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

このコマンド グループはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

Azure Quantumワークスペースを管理し、Azure Quantum プロバイダーにジョブを送信します。

コマンド

名前 説明 状態
az quantum execute

Azure Quantumで実行するジョブを送信し、結果を待ちます。 az quantum runに相当します。

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で実行するジョブを送信し、結果を待ちます。 az quantum executeに相当します。

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

ワークスペース api キー Azure Quantum管理します。

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
                   [--acquire-policy-token]
                   [--change-reference]
                   [--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

必須のパラメーター

--job-input-file

送信する入力ファイルの場所。

--job-input-format

送信するファイルの形式。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--target-id -t

量子コンピューティング ジョブの実行エンジン。 ワークスペースが一連のプロバイダーで構成されている場合、それぞれ 1 つ以上のターゲットが有効になります。 az quantum target setを使用して既定のターゲットを構成できます。

--workspace-name -w

Quantum ワークスペースの名前。 az quantum workspace setを使用して既定のワークスペースを構成できます。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--entry-point

QIR プログラムまたは回線のエントリ ポイント。 一部のプロバイダー QIR ジョブに必要です。

--job-name

プログラムのこの実行に付けるフレンドリ名。

--job-output-format

予想されるジョブ出力形式。

--job-params

キーと値のペア、json 文字列、または json コンテンツを含む @{file} のリストとしてターゲットに渡されるジョブ パラメーター。

--location
非推奨

オプション '--location' は非推奨となり、2026 年 5 月に削除されます。

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

--shots

指定されたターゲットでプログラムを実行する回数。

--storage

指定した場合、ジョブ データと結果を格納するために、Azure Storageの ConnectionString が使用されます。

--target-capability

コンパイラに渡されるターゲット機能パラメーター。

-l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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
               [--acquire-policy-token]
               [--change-reference]
               [--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

必須のパラメーター

--job-input-file

送信する入力ファイルの場所。

--job-input-format

送信するファイルの形式。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--target-id -t

量子コンピューティング ジョブの実行エンジン。 ワークスペースが一連のプロバイダーで構成されている場合、それぞれ 1 つ以上のターゲットが有効になります。 az quantum target setを使用して既定のターゲットを構成できます。

--workspace-name -w

Quantum ワークスペースの名前。 az quantum workspace setを使用して既定のワークスペースを構成できます。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--entry-point

QIR プログラムまたは回線のエントリ ポイント。 一部のプロバイダー QIR ジョブに必要です。

--job-name

プログラムのこの実行に付けるフレンドリ名。

--job-output-format

予想されるジョブ出力形式。

--job-params

キーと値のペア、json 文字列、または json コンテンツを含む @{file} のリストとしてターゲットに渡されるジョブ パラメーター。

--location
非推奨

オプション '--location' は非推奨となり、2026 年 5 月に削除されます。

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

--shots

指定されたターゲットでプログラムを実行する回数。

--storage

指定した場合、ジョブ データと結果を格納するために、Azure Storageの ConnectionString が使用されます。

--target-capability

コンパイラに渡されるターゲット機能パラメーター。

-l
非推奨

引数 '--location' は非推奨となり、2026 年 5 月に削除されます。

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False