az quantum

預覽

Note

此參考是Azure CLIquantum擴充（版本2.73.0或更高版本）的一部分。擴充功能會在您第一次執行 az quantum 命令時自動安裝。深入了解擴充功能。

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

管理 Azure Quantum Workspaces 並向 Azure Quantum Providers 提交工作。

命令

名稱	Description	類型	狀態
az quantum execute	提交一個工作要在 Azure Quantum 上執行，然後等待結果。相當於 `az quantum run`。	Extension	Preview
az quantum job	Manage jobs for Azure Quantum.	Extension	Preview
az quantum job cancel	如果 Azure Quantum 上的工作尚未完成，請申請取消。	Extension	Preview
az quantum job delete	從 Azure Quantum 工作空間刪除工作。	Extension	Preview
az quantum job file	管理量子作業相關的檔案。	Extension	Preview
az quantum job file download	從作業的輸出儲存容器下載檔案。	Extension	Preview
az quantum job file list	列出儲存在作業輸出儲存容器中的檔案。	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 update	更新已提交工作的名稱、優先順序和/或標籤。	Extension	Preview
az quantum job wait	將 CLI 置於等候狀態，直到作業完成執行為止。	Extension	Preview
az quantum offerings	管理 Azure Quantum 的提供者供應。	Extension	Preview
az quantum offerings accept-terms	接受提供者和 SKU 組合的條款，以啟用它以建立工作區。	Extension	Preview
az quantum offerings list	取得指定位置上所有可用的提供者供應項目清單。	Extension	Preview
az quantum offerings show-terms	顯示提供者和 SKU 組合的條款，包括授權 URL 和接受狀態。	Extension	Preview
az quantum run	提交一個工作要在 Azure Quantum 上執行，然後等待結果。相當於 `az quantum execute`。	Extension	Preview
az quantum suite-offer	查看 Azure Quantum 套件中可供訂閱使用的 V2 供應商優惠。	Extension	Preview
az quantum suite-offer list	目前訂閱可使用的 V2 提供者套件清單，包括提供者 ID、名稱、公司及地點。	Extension	Preview
az quantum suite-offer quotas	查看目前訂閱中 V2 供應商套件的配額分配及其消耗使用情況。	Extension	Preview
az quantum suite-offer target	List 透過 Azure Quantum 套件提供畀 V2 provider 嘅目標。	Extension	Preview
az quantum suite-offer target list	透過 V2 提供者套件提供目標及其狀態，無需工作區即可取得。	Extension	Preview
az quantum target	Manage targets for Azure Quantum workspaces.	Extension	Preview
az quantum target clear	清除預設的目標識別碼。	Extension	Preview
az quantum target list	在 Azure Quantum 工作空間中取得提供者清單及其目標。	Extension	Preview
az quantum target set	在向 Azure Quantum 提交工作時，選擇預設目標來使用。	Extension	Preview
az quantum target show	取得目前預設目標的目標 ID，以便在提交工作給 Azure Quantum 時使用。	Extension	Preview
az quantum workspace	Manage Azure Quantum workspaces.	Extension	Preview
az quantum workspace clear	清除預設的 Azure Quantum 工作空間。	Extension	Preview
az quantum workspace create	建立一個新嘅 Azure Quantum 工作空間。	Extension	Preview
az quantum workspace delete	刪除給定（或目前）的 Azure Quantum 工作空間。	Extension	Preview
az quantum workspace keys	Manage Azure Quantum Workspace API keys.	Extension	Preview
az quantum workspace keys list	列出給定（或目前）Azure Quantum workspace 的 API 鍵。	Extension	Preview
az quantum workspace keys regenerate	Regenerate API key for the given （或current the given of the given or current） Azure Quantum workspace.	Extension	Preview
az quantum workspace list	取得可用 Azure Quantum 工作空間清單。	Extension	Preview
az quantum workspace quotas	List quota allocations and consumed usages for a Azure Quantum workspace.	Extension	Preview
az quantum workspace set	選擇預設 Azure Quantum workspace for future commands。	Extension	Preview
az quantum workspace show	取得給定（或目前）Azure Quantum 工作區的詳細資訊。	Extension	Preview
az quantum workspace update	更新指定（或目前）的 Azure Quantum 工作空間。	Extension	Preview
az quantum workspace user	管理 Azure Quantum 工作空間的使用者。	Extension	Preview
az quantum workspace user add	Grant a user access to a Azure Quantum workspace.	Extension	Preview
az quantum workspace user list	列出有權限使用 Azure Quantum 工作空間的使用者。	Extension	Preview
az quantum workspace user remove	移除使用者對 Azure Quantum 工作空間的存取權。	Extension	Preview

az quantum execute

預覽

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

提交一個工作要在 Azure Quantum 上執行，然後等待結果。相當於 az quantum run。

az quantum execute --job-input-file
                   --job-input-format
                   --resource-group
                   --target-id
                   --workspace-name
                   [--acquire-policy-token]
                   [--change-reference]
                   [--entry-point]
                   [--job-name]
                   [--job-output-format]
                   [--job-params]
                   [--shots]
                   [--storage]
                   [--target-capability]

範例

從目前資料夾中的檔案執行 QIR 位碼，並等候結果。

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

在 Rigetti 模擬器上執行 Quil 傳遞作業，並等候結果。

az quantum execute -g MyResourceGroup -w MyWorkspace \
   -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

使用作業參數將 Qiskit 線路提交至 IonQ 模擬器，並等候結果。

az quantum execute -g MyResourceGroup -w MyWorkspace \
   -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

要送出之檔案的格式。

--resource-group -g

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

--target-id -t

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

--workspace-name -w

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

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

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

預覽