az quantum

注意

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

管理 Azure Quantum 工作區,並將作業提交至 Azure Quantum 提供者。

命令

az quantum execute

提交作業以在 Azure Quantum 上執行,並等候結果。

az quantum job

管理 Azure Quantum 的作業。

az quantum job cancel

如果作業尚未完成,請要求取消 Azure Quantum 上的作業。

az quantum job list

取得 Quantum Workspace 中的作業清單。

az quantum job output

取得執行 Q# 作業的結果。

az quantum job show

取得作業的狀態和詳細資料。

az quantum job submit

提交 Q# 專案以在 Azure Quantum 上執行。

az quantum job wait

讓 CLI 處於等候狀態,直到作業完成執行為止。

az quantum offerings

管理 Azure Quantum 的提供者供應專案。

az quantum offerings accept-terms

接受提供者和 SKU 組合的條款,以便建立工作區。

az quantum offerings list

取得指定位置上可用的所有提供者供應專案清單。

az quantum offerings show-terms

顯示提供者和 SKU 組合的條款,包括授權 URL 和接受狀態。

az quantum run

相當於 az quantum execute

az quantum target

管理 Azure Quantum 工作區的目標。

az quantum target clear

清除預設的目標識別碼。

az quantum target list

取得 Azure Quantum 工作區中的提供者及其目標清單。

az quantum target set

選取將作業提交至 Azure Quantum 時要使用的預設目標。

az quantum target show

取得將作業提交至 Azure Quantum 時要使用的指定 (或目前) 目標的詳細資料。

az quantum workspace

管理 Azure Quantum 工作區。

az quantum workspace clear

清除預設的 Azure Quantum 工作區。

az quantum workspace create

建立新的 Azure Quantum 工作區。

az quantum workspace delete

刪除指定的 (或目前) Azure Quantum 工作區。

az quantum workspace list

取得可用的 Azure Quantum 工作區清單。

az quantum workspace quotas

列出指定 (或目前) Azure Quantum 工作區的配額。

az quantum workspace set

針對未來的命令選取預設的 Azure Quantum 工作區。

az quantum workspace show

取得指定 (或目前) Azure Quantum 工作區的詳細資料。

az quantum execute

提交作業以在 Azure Quantum 上執行,並等候結果。

az quantum execute [--job-name]
                   [--job-params]
                   [--location]
                   [--no-build]
                   [--project]
                   [--resource-group]
                   [--shots]
                   [--storage]
                   [--target-capability]
                   [--target-id]
                   [--workspace-name]
                   [<PROGRAM_ARGS>]

範例

從目前資料夾提交 Q# 程式,並等候結果。

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

使用作業和程式參數,從目前資料夾中提交並等候 Q# 程式。

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

從具有目標功能參數的目前資料夾中提交並等候 Q# 程式。

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

選擇性參數

--job-name

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

--job-params

傳遞至目標的作業參數做為 key=value 組的清單。

--location -l

位置。 值的來源:az account list-locations。 您可以使用 az configure --defaults location=<location> 來設定預設位置。

--no-build

如果指定,則不會在提交之前建置 Q# 程式。

--project

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

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--shots

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

--storage

如果指定,則會使用 Azure 儲存體的 ConnectionString 來儲存作業資料和結果。

--target-capability

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

--target-id -t

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

--workspace-name -w

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

<PROGRAM_ARGS>

Q# 作業所預期的引數清單,指定為 --name=value 之後 --

az quantum run

相當於 az quantum execute

az quantum run [--job-name]
               [--job-params]
               [--location]
               [--no-build]
               [--project]
               [--resource-group]
               [--shots]
               [--storage]
               [--target-capability]
               [--target-id]
               [--workspace-name]
               [<PROGRAM_ARGS>]

範例

從目前資料夾提交 Q# 程式,並等候結果。

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

使用作業和程式參數,從目前資料夾中提交並等候 Q# 程式。

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

從具有目標功能參數的目前資料夾中提交並等候 Q# 程式。

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

選擇性參數

--job-name

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

--job-params

傳遞至目標的作業參數做為 key=value 組的清單。

--location -l

位置。 值的來源:az account list-locations。 您可以使用 az configure --defaults location=<location> 來設定預設位置。

--no-build

如果指定,則不會在提交之前建置 Q# 程式。

--project

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

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--shots

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

--storage

如果指定,則會使用 Azure 儲存體的 ConnectionString 來儲存作業資料和結果。

--target-capability

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

--target-id -t

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

--workspace-name -w

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

<PROGRAM_ARGS>

Q# 作業所預期的引數清單,指定為 --name=value 之後 --