az quantum job

  • 預覽
  • 參考

注意

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

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

管理 Azure Quantum 的工作。

命令

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

範例

依標識碼取消 Azure Quantum 作業。

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

必要參數

--job-id -j

GUID 格式的作業唯一標識碼。

--location -l

位置。​​ 來自的值： 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

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

位置。​​ 來自的值： 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

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

位置。​​ 來自的值： 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

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

位置。​​ 來自的值： 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

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

提交具有程序參數的 Q# 程式（例如 n-qubits = 2）。

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

使用 target-capability 參數，從目前資料夾提交 Q# 程式。

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

從目前資料夾中的檔案提交 QIR bitcode 或人類可讀取的 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

位置。​​ 來自的值： 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 的必要專案。 在 Q# 作業上忽略。

--job-input-file

要送出之輸入檔的位置。 QIR、QIO 和傳遞作業的必要專案。 在 Q# 作業上忽略。

--job-input-format

要送出之檔案的格式。 在 Q# 作業上省略此參數。

--job-name

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

--job-output-format

預期的作業輸出格式。 在 Q# 作業上忽略。

--job-params

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

--no-build

[已淘汰]如果指定，則不會在提交之前建置 Q# 程式。

預設值: False
--project

[已淘汰]要提交之 Q# 專案的位置。 預設為目前資料夾。

--shots

在指定目標上執行 Q# 程式的次數。

--storage

如果指定，則會使用 Azure 儲存體 的 連線 ionString 來儲存作業數據和結果。

--target-capability

傳遞至編譯程序的目標功能參數。

<PROGRAM_ARGS>

Q# 作業所預期的自變數清單，指定為 --name=value 之後 --。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

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

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

--subscription

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

位置。​​ 來自的值： 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

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。