次の方法で共有


az quantum

Note

このリファレンスは、Azure CLI (バージョン 2.73.0 以降) の 量子 拡張機能の一部です。 拡張機能は、 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

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

必須のパラメーター

--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 つ以上が必要になる場合があります。

--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
               [--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 つ以上が必要になる場合があります。

--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