az quantum

プレビュー

Note

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

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

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

コマンド

Name	説明	型	状態
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 delete	Azure Quantum ワークスペースからジョブを削除します。	Extension	Preview
az quantum job file	量子ジョブの関連ファイルを管理します。	Extension	Preview
az quantum job file download	ジョブの出力ストレージコンテナーからファイルをダウンロードします。	Extension	Preview
az quantum job file list	ジョブの出力ストレージコンテナーに格納されているファイルを一覧表示します。	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 update	送信されたジョブの名前、優先度、タグを更新します。	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 suite-offer	サブスクリプションAzure Quantum利用可能な V2 プロバイダーのスイートオファーを表示します。	Extension	Preview
az quantum suite-offer list	プロバイダー ID、名前、会社、場所など、現在のサブスクリプションで使用できる V2 プロバイダースイートオファーを一覧表示します。	Extension	Preview
az quantum suite-offer quotas	現在のサブスクリプションの V2 プロバイダースイートオファーのクォータ割り当てとその使用量を表示します。	Extension	Preview
az quantum suite-offer target	V2 プロバイダーのAzure Quantum スイートオファーで使用可能なターゲットを一覧表示します。	Extension	Preview
az quantum suite-offer target list	ワークスペースを必要とせずに、V2 プロバイダースイートオファーを通じて使用可能なターゲットとその状態を一覧表示します。	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 workspace user	Azure Quantum ワークスペースのユーザーを管理します。	Extension	Preview
az quantum workspace user add	Azure Quantum ワークスペースへのアクセス権をユーザーに付与します。	Extension	Preview
az quantum workspace user list	Azure Quantum ワークスペースにアクセスできるユーザーを一覧表示します。	Extension	Preview
az quantum workspace user remove	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]
                   [--shots]
                   [--storage]
                   [--target-capability]

例

現在のフォルダー内のファイルから QIR ビットコードを実行し、結果を待ちます。

az quantum execute -g MyResourceGroup -w MyWorkspace -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 \
   -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 \
   -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} のリストとしてターゲットに渡されるジョブパラメーター。

--shots

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

--storage

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

--target-capability

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

グローバルパラメーター

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