Share via

az quantum job

  • プレビュー
  • リファレンス

Note

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

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

Azure Quantum のジョブを管理します。

コマンド

名前 説明 型 Status
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 job cancel

プレビュー

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

完了していない場合は、Azure Quantum のジョブを取り消す要求。

az quantum job cancel --job-id
                      --location
                      --resource-group
                      --workspace-name

例

ID で Azure Quantum ジョブを取り消します。

az quantum job cancel -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

必須のパラメーター

--job-id -j

GUID 形式のジョブの一意識別子。

--location -l

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

--resource-group -g

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

--workspace-name -w

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

グローバル パラメーター
--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 job list

プレビュー

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

Quantum ワークスペース内のジョブの一覧を取得します。

az quantum job list --location
                    --resource-group
                    --workspace-name

例

Azure Quantum ワークスペースからジョブの一覧を取得します。

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation

必須のパラメーター

--location -l

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

--resource-group -g

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

--workspace-name -w

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

グローバル パラメーター
--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 job output

プレビュー

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

ジョブの実行結果を取得します。

az quantum job output --job-id
                      --location
                      --resource-group
                      --workspace-name
                      [--item]

例

成功した Azure Quantum ジョブの結果を出力します。

az quantum job output -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy -o table

必須のパラメーター

--job-id -j

GUID 形式のジョブの一意識別子。

--location -l

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

--resource-group -g

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

--workspace-name -w

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

省略可能のパラメーター

--item

バッチ処理ジョブの項目インデックス。

グローバル パラメーター
--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 job show

プレビュー

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

ジョブの状態と詳細を取得します。

az quantum job show --job-id
                    --location
                    --resource-group
                    --workspace-name

例

Azure Quantum ジョブの状態を取得します。

az quantum job show -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --query status

必須のパラメーター

--job-id -j

GUID 形式のジョブの一意識別子。

--location -l

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

--resource-group -g

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

--workspace-name -w

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

グローバル パラメーター
--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 job submit

プレビュー

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

Azure Quantum で実行するプログラムまたは回線を送信します。

az quantum job submit --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 job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob

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

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob --job-params param1=value1 param2=value2

プログラム パラメーター (n 量子ビット = 2 など) を含む Q# プログラムを送信します。

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob -- --n-qubits=2

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

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

現在のフォルダー内のファイルから QIR ビットコードまたは人間が判読できる LLVM コードを送信します。

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

必須のパラメーター

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

プレビュー

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

ジョブの実行が完了するまで、CLI を待機状態にします。

az quantum job wait --job-id
                    --location
                    --resource-group
                    --workspace-name
                    [--max-poll-wait-secs]

例

ジョブの完了を待ち、60 秒間隔でチェックします。

az quantum job wait -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table

必須のパラメーター

--job-id -j

GUID 形式のジョブの一意識別子。

--location -l

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

--resource-group -g

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

--workspace-name -w

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

省略可能のパラメーター

--max-poll-wait-secs

対応するジョブの結果を Azure Quantum に照会するためのポーリング時間 (秒単位)。

既定値: 5
グローバル パラメーター
--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 を使います。