次の方法で共有

az quantum job

  • プレビュー

Note

This reference is part of the quantum extension for the Azure CLI (version 2.41.0 or higher). 拡張機能は、az quantum job コマンドを初めて実行するときに自動的にインストールされます。 Learn more about extensions.

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

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

コマンド

名前 説明 型 状態
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 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

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

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

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

--only-show-errors

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

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

Output format.

プロパティ 値
規定値: 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 job list

プレビュー

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

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

az quantum job list --location
                    --resource-group
                    --workspace-name
                    [--created-after]
                    [--created-before]
                    [--item-type]
                    [--job-name]
                    [--job-type]
                    [--order]
                    [--orderby]
                    [--provider-id]
                    [--skip]
                    [--status]
                    [--target-id]
                    [--top]

例

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

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

microsoft 要素プロバイダーを使用したジョブを一覧表示します。

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --provider-id microsoft-elements

microsoft.dft ターゲットで実行されたジョブを一覧表示します。

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id microsoft.dft

正常に完了したジョブを一覧表示します。

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

2025 年 1 月 15 日以降に作成されたジョブを一覧表示します。

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --created-after 2025-01-15

名前が "Generate..." で始まるジョブを一覧表示します。

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

最初の 50 個のジョブをスキップし、51 番目のジョブで一覧表示を開始し、10 個のジョブを一覧表示します。

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --skip 50 --top 10

ターゲット ID でジョブ リストを並べ替え、表形式で表示します。

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Target -o table

ジョブ一覧をジョブ名で降順に並べ替え、表形式で表示します。

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Name --order desc -o table

必須のパラメーター

--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を使用して既定のワークスペースを構成できます。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created-after

この日付より後に作成されたジョブが一覧表示されます。

--created-before

この日付より前に作成されたジョブが一覧表示されます。

--item-type

一覧表示される項目の種類、"job" または "session" です。

--job-name

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

--job-type

一覧表示されるジョブの種類 ("QuantumComputing" の例)。

--order

リストを並べ替える方法:asc または desc。

--orderby

リストを並べ替えるフィールド。

--provider-id -p

Azure Quantum プロバイダーの識別子。

--skip

ジョブ リストを返すときにスキップするジョブの数。

--status

一覧表示するジョブの状態。

--target-id -t

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

--top

ページごとに一覧表示されるジョブの数。

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

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

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

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

--only-show-errors

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

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

Output format.

プロパティ 値
規定値: 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 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を使用して既定のワークスペースを構成できます。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--item

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

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

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

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

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

--only-show-errors

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

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

Output format.

プロパティ 値
規定値: 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 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

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

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

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

--only-show-errors

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

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

Output format.

プロパティ 値
規定値: 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 job submit

プレビュー

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

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

az quantum job submit --job-input-file
                      --job-input-format
                      --location
                      --resource-group
                      --target-id
                      --workspace-name
                      [--entry-point]
                      [--job-name]
                      [--job-output-format]
                      [--job-params]
                      [--shots]
                      [--storage]
                      [--target-capability]

例

現在のフォルダー内のファイルから QIR ビットコードを送信します。

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

リゲッティ シミュレーターに Quil パススルー ジョブを送信します。

az quantum job submit -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 job submit -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

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

--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を使用して既定のワークスペースを構成できます。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Output format.

プロパティ 値
規定値: 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 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を使用して既定のワークスペースを構成できます。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-poll-wait-secs

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

プロパティ 値
規定値: 5
グローバル パラメーター
--debug

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

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

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

--only-show-errors

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

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

Output format.

プロパティ 値
規定値: 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