az quantum workspace

預覽

Note

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

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

Manage Azure Quantum workspaces.

命令

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

預覽

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

清除預設的 Azure Quantum 工作空間。

清除已儲存的資源群組和工作區名稱預設值。其他設定，包括預設訂閱、地點和目標，則保持不變。

az quantum workspace clear [--acquire-policy-token]
                           [--change-reference]

範例

如果之前設定過，請清除預設的 Azure Quantum 工作區。

az quantum workspace clear

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

全域參數

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

預覽

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

建立一個新嘅 Azure Quantum 工作空間。

az quantum workspace create --location
                            --resource-group
                            --storage-account
                            --workspace-name
                            [--acquire-policy-token]
                            [--auto-accept]
                            [--change-reference]
                            [--provider-sku-list]
                            [--quota]
                            [--skip-autoadd]
                            [--skip-role-assignment]
                            [--workspace-kind {V1, V2}]

範例

建立一個新的 Azure Quantum 工作空間，與提供免費信用的供應商一起使用。

az quantum workspace create -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -a MyStorageAccountName

建立一個新的 Azure Quantum 工作空間，並列出特定的提供者清單。

az quantum workspace create -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -r "MyProvider1 / MySKU1, MyProvider2 / MySKU2" --skip-autoadd -a MyStorageAccountName

To display a list of available providers and their SKUs, use the following command:
    az quantum offerings list -l MyLocation -o table

建立一個 V2 工作空間，為提供者目標分配配額。

az quantum workspace create -g MyResourceGroup -w MyWorkspace -l MyLocation \
    --workspace-kind V2 -r "MyProvider/default" --skip-autoadd -a MyStorageAccountName \
    --quota provider-id=MyProvider target-id=MyProvider.Target1 standard-minutes-lifetime=500 high-minutes-lifetime=50 \
    --quota provider-id=MyProvider target-id=MyProvider.Target2 standard-minutes-lifetime=250

必要參數

--location -l

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

--resource-group -g

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

--storage-account -a

要供量子工作區使用的記憶體帳戶名稱。

--workspace-name -w

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

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--auto-accept

如果指定，則會接受提供者條款，而不需要互動式 Y/N 提示。

屬性	值
預設值:	False

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--provider-sku-list -r

提供者/SKU 配對的逗號分隔清單。以斜線分隔提供者和 SKU。以引號括住整個清單。來自 az quantum offerings list -l <location> -o table的值。

--quota

V2 工作空間的目標配額配置為提供者 ID、目標 ID、標準分鐘-壽命，以及可選的高分鐘-壽命鍵=值對、JSON 物件或陣列，或 @{file} 包含 JSON 內容。建立工作區時使用 --workspace-kind V2。數值為絕對值，且不得超過套件目標分配，更新時也不能低於目前工作區使用量。新分配需標準分鐘-壽命。 camelCase 鍵數（providerId、targetId 等）也被接受。重複——每個目標一次配額。

--skip-autoadd

如果指定，則不會自動新增提供免費點數的方案。

屬性	值
預設值:	False

--skip-role-assignment

略過記憶體帳戶中量子工作區的角色指派步驟。

屬性	值
預設值:	False

--workspace-kind

那種可以創造的工作空間。使用 V2 來分配 V2 提供者及每個目標的配額。

屬性	值
接受的值:	V1, V2

全域參數

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

預覽

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

刪除給定（或目前）的 Azure Quantum 工作空間。

az quantum workspace delete --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]

範例

依資源群組和工作區名稱刪除 Azure Quantum 工作空間。如果已設定預設工作區，則不需要 -g 和 -w 參數。

az quantum workspace delete -g MyResourceGroup -w MyWorkspace

必要參數

--resource-group -g

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

--workspace-name -w

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

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

全域參數

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

預覽

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

取得可用 Azure Quantum 工作空間清單。

az quantum workspace list [--location]
                          [--resource-group]
                          [--tag]

範例

取得所有可用 Azure Quantum 工作空間的清單。

az quantum workspace list

取得某地點可用的 Azure Quantum 工作空間列表。

az quantum workspace list -l MyLocation

選擇性參數

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

--location -l

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

--resource-group -g

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

--tag

只顯示已關聯指定標記的量子工作區。

全域參數

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

預覽

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

List quota allocations and consumed usages for a Azure Quantum workspace.

保留 V1 提供者現有的配額維度回應。對於 V2 供應商，會為每個目標分別回傳 StandardMinutesLifetime 與 HighMinutesLifetime 列，並以分鐘計報 targetId、limit（限制）及利用率（minity）。缺少的配置值或使用值會回傳為 0。

az quantum workspace quotas --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]

範例

查看給定（或目前）工作區的配額分配與使用情況。如果已設定預設工作區，則不需要 -g 和 -w 參數。

az quantum workspace quotas -g MyResourceGroup -w MyWorkspace -o table

必要參數

--resource-group -g

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

--workspace-name -w

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

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

全域參數

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

預覽

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

選擇預設 Azure Quantum workspace for future commands。

將資源群組和工作區名稱儲存為 persistent Azure CLI flag defaults。資源群組預設會與其他 Azure CLI 指令共享。這些設定會在終端機會話中持續存在。

明確的 --resource-group 與 --workspace-name 參數分別覆蓋各自的預設值。針對其他工作空間的指令不會改變已儲存的預設值。

此指令不會改變預設訂閱或地點。使用 'az quantum workspace clear' 清除已儲存的資源群組和工作區名稱預設值。

az quantum workspace set --resource-group
                         --workspace-name
                         [--acquire-policy-token]
                         [--change-reference]

範例

Set the default Azure Quantum workspace.

az quantum workspace set -g MyResourceGroup -w MyWorkspace

必要參數

--resource-group -g

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

--workspace-name -w

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

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

全域參數

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

預覽

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

取得給定（或目前）Azure Quantum 工作區的詳細資訊。

az quantum workspace show [--resource-group]
                          [--workspace-name]

範例

顯示目前選擇的預設 Azure Quantum 工作空間。

az quantum workspace show

顯示所提供的 Azure Quantum 工作空間詳情。

az quantum workspace show -g MyResourceGroup -w MyWorkspace

選擇性參數

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

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

預覽

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

更新指定（或目前）的 Azure Quantum 工作空間。

透過「--quota」進行目標配額分配，僅支援 V2 工作空間。

az quantum workspace update [--acquire-policy-token]
                            [--change-reference]
                            [--enable-api-key]
                            [--quota]
                            [--resource-group]
                            [--workspace-name]

範例

Enable a provided a Azure Quantum workspace api keys.

az quantum workspace update --enable-api-key True

Disable a provided a Provided Azure Quantum workspace api keys.

az quantum workspace update --enable-api-key False

更新 V2 工作空間的目標配額配置。

az quantum workspace update -g MyResourceGroup -w MyWorkspace \
    --quota provider-id=MyProvider target-id=MyProvider.Target1 standard-minutes-lifetime=1000

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--enable-api-key

啟用或停用 API 金鑰驗證。

--quota

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

意見反應

此頁面對您有幫助嗎？