共用方式為

az quantum job

  • 預覽

Note

此參考是 Azure CLI 量 子 延伸模組的一部分 （2.73.0 版或更新版本）。 擴充功能會在您第一次執行 az quantum job 命令時自動安裝。 深入了解擴充功能。

命令群組 『quantum』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

管理 Azure Quantum 的工作。

命令

名稱 Description 類型 狀態
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

範例

依標識碼取消 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

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 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

列出使用 quantinuum 提供者的工作。

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

列出在 ionq.simulator 目標上執行的任務。

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id ionq.simulator

列出成功完成的工作。

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

依目標識別元排序作業清單，並以表格式顯示。

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。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

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

量子運算作業的執行引擎。 當工作區設定為一組提供者時，它們都會啟用一或多個目標。 您可以使用 來設定預設目標 az quantum target set。

--top

每個頁面列出的作業數目。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 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

範例

列印成功的 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。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 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

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 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 傳遞作業提交至 Rigetti 模擬器。

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 JSON 線路提交至 IonQ 模擬器。

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

量子運算作業的執行引擎。 當工作區設定為一組提供者時，它們都會啟用一或多個目標。 您可以使用 來設定預設目標 az quantum target set。

--workspace-name -w

Quantum 工作區的名稱。 您可以使用 來設定預設工作區 az quantum workspace set。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--entry-point

QIR 程式或線路的進入點。 某些提供者 QIR 工作需要。

--job-name

要提供給此程式的易記名稱。

--job-output-format

預期的作業輸出格式。

--job-params

傳遞至目標做為 key=value pair、json 字串或 @{file} json 內容列表的作業參數。

--shots

在指定目標上執行程序的次數。

--storage

如果指定，則會使用 Azure 儲存體 的 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

訂用帳戶的名稱或標識碼。 您可以使用 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。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--max-poll-wait-secs

查詢 Azure Quantum 以秒為單位來查詢對應作業結果的輪詢時間。

屬性 值
預設值: 5
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False