az quantum

Note

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

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

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

コマンド

名前	説明	型	Status
az quantum execute	Azure Quantum で実行するジョブを送信し、結果を待機します。	拡張子	プレビュー
az quantum job	Azure Quantum のジョブを管理します。	拡張子	プレビュー
az quantum job cancel	完了していない場合は、Azure Quantum のジョブを取り消す要求。	拡張子	プレビュー
az quantum job list	Quantum ワークスペース内のジョブの一覧を取得します。	拡張子	プレビュー
az quantum job output	ジョブの実行結果を取得します。	拡張子	プレビュー
az quantum job show	ジョブの状態と詳細を取得します。	拡張子	プレビュー
az quantum job submit	Azure Quantum で実行するプログラムまたは回線を送信します。	拡張子	プレビュー
az quantum job wait	ジョブの実行が完了するまで、CLI を待機状態にします。	拡張子	プレビュー
az quantum offerings	Azure Quantum のプロバイダー オファリングを管理します。	拡張子	プレビュー
az quantum offerings accept-terms	プロバイダーと SKU の組み合わせの条件に同意して、ワークスペースの作成を有効にします。	拡張子	プレビュー
az quantum offerings list	特定の場所で使用可能なすべてのプロバイダー オファリングの一覧を取得します。	拡張子	プレビュー
az quantum offerings show-terms	プロバイダーと SKU の組み合わせの条件 (ライセンス URL や同意状態など) を表示します。	拡張子	プレビュー
az quantum run	これは、az quantum execute に相当します。	拡張子	プレビュー
az quantum target	Azure Quantum ワークスペースのターゲットを管理します。	拡張子	プレビュー
az quantum target clear	既定の target-id をクリアします。	拡張子	プレビュー
az quantum target list	Azure Quantum ワークスペース内のプロバイダーとそのターゲットの一覧を取得します。	拡張子	プレビュー
az quantum target set	Azure Quantum にジョブを送信するときに使用する既定のターゲットを選択します。	拡張子	プレビュー
az quantum target show	Azure Quantum にジョブを送信するときに使用する現在の既定のターゲットのターゲット ID を取得します。	拡張子	プレビュー
az quantum workspace	Azure Quantum ワークスペースを管理します。	拡張子	プレビュー
az quantum workspace clear	既定の Azure Quantum ワークスペースをクリアします。	拡張子	プレビュー
az quantum workspace create	新しい Azure Quantum ワークスペースを作成します。	拡張子	プレビュー
az quantum workspace delete	指定された (または現在の) Azure Quantum ワークスペースを削除します。	拡張子	プレビュー
az quantum workspace keys	Azure Quantum Workspace API キーを管理します。	拡張子	プレビュー
az quantum workspace keys list	特定の (または現在の) Azure Quantum ワークスペースの API キーを一覧表示します。	拡張子	プレビュー
az quantum workspace keys regenerate	特定の (または現在の) Azure Quantum ワークスペースの API キーを再生成します。	拡張子	プレビュー
az quantum workspace list	使用可能な Azure Quantum ワークスペースの一覧を取得します。	拡張子	プレビュー
az quantum workspace quotas	特定の (または現在の) Azure Quantum ワークスペースのクォータを一覧表示します。	拡張子	プレビュー
az quantum workspace set	今後のコマンド用に既定の Azure Quantum ワークスペースを選択します。	拡張子	プレビュー
az quantum workspace show	指定された (または現在の) Azure Quantum ワークスペースの詳細を取得します。	拡張子	プレビュー
az quantum workspace update	指定された (または現在の) Azure Quantum ワークスペースを更新します。	拡張子	プレビュー

az quantum execute

プレビュー

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

Azure Quantum で実行するジョブを送信し、結果を待機します。

az quantum execute --location
                   --resource-group
                   --target-id
                   --workspace-name
                   [--entry-point]
                   [--job-input-file]
                   [--job-input-format]
                   [--job-name]
                   [--job-output-format]
                   [--job-params]
                   [--no-build]
                   [--project]
                   [--shots]
                   [--storage]
                   [--target-capability]
                   [<PROGRAM_ARGS>]

例

現在のフォルダーから Q# プログラムを送信し、結果を待ちます。

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

ジョブとプログラムのパラメーターを含む現在のフォルダーから Q# プログラムを送信して待機します。

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

ターゲット機能パラメーターを使用して、現在のフォルダーから Q# プログラムを送信して待機します。

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

必須のパラメーター

--location -l

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

--resource-group -g

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

--target-id -t

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

--workspace-name -w

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

省略可能のパラメーター

--entry-point

QIR プログラムまたは回線のエントリ ポイント。 QIR に必要です。 Q# ジョブでは無視されます。

--job-input-file

送信する入力ファイルの場所。 QIR、QIO、およびパススルー ジョブに必要です。 Q# ジョブでは無視されます。

--job-input-format

送信するファイルの形式。 Q# ジョブでは、このパラメーターを省略します。

--job-name

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

--job-output-format

予想されるジョブ出力形式。 Q# ジョブでは無視されます。

--job-params

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

--no-build

[非推奨]指定した場合、Q# プログラムは送信前にビルドされません。

既定値: False

--project

[非推奨]送信する Q# プロジェクトの場所。 既定値は現在のフォルダーです。

--shots

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

--storage

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

--target-capability

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

<PROGRAM_ARGS>

--name=value の後 --に指定された Q# 操作で予期される引数の一覧。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az quantum run

プレビュー

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

これは、az quantum execute に相当します。

az quantum run --location
               --resource-group
               --target-id
               --workspace-name
               [--entry-point]
               [--job-input-file]
               [--job-input-format]
               [--job-name]
               [--job-output-format]
               [--job-params]
               [--no-build]
               [--project]
               [--shots]
               [--storage]
               [--target-capability]
               [<PROGRAM_ARGS>]

例

現在のフォルダーから Q# プログラムを送信し、結果を待ちます。

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

ジョブとプログラムのパラメーターを含む現在のフォルダーから Q# プログラムを送信して待機します。

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

ターゲット機能パラメーターを使用して、現在のフォルダーから Q# プログラムを送信して待機します。

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

必須のパラメーター

--location -l

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

--resource-group -g

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

--target-id -t

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

--workspace-name -w

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

省略可能のパラメーター

--entry-point

QIR プログラムまたは回線のエントリ ポイント。 QIR に必要です。 Q# ジョブでは無視されます。

--job-input-file

送信する入力ファイルの場所。 QIR、QIO、およびパススルー ジョブに必要です。 Q# ジョブでは無視されます。

--job-input-format

送信するファイルの形式。 Q# ジョブでは、このパラメーターを省略します。

--job-name

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

--job-output-format

予想されるジョブ出力形式。 Q# ジョブでは無視されます。

--job-params

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

--no-build

[非推奨]指定した場合、Q# プログラムは送信前にビルドされません。

既定値: False

--project

[非推奨]送信する Q# プロジェクトの場所。 既定値は現在のフォルダーです。

--shots

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

--storage

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

--target-capability

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

<PROGRAM_ARGS>

--name=value の後 --に指定された Q# 操作で予期される引数の一覧。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。