使用 Azure CLI 管理量子工作區

發行項
10/28/2023

在本指南中，您將了解如何使用 Azure 命令列介面 (Azure CLI) 來建立 Azure Quantum 工作區及必要的資源群組和儲存體帳戶，並開始在 Azure Quantum 中執行量子應用程式。

必要條件

若要使用 Azure Quantum 服務，您需要：

具備有效訂用帳戶的 Azure 帳戶。如果您沒有 Azure 帳戶，請免費註冊並註冊隨用隨付訂用帳戶。
量子工作區所在的 Azure 資源群組。
資源群組中要與量子工作區產生關聯的儲存體帳戶。多個工作區可以與相同的帳戶建立關聯。
Azure CLI。
Microsoft Quantum Development Kit。

環境設定

安裝 Azure CLI quantum 擴充功能。開啟命令提示字元並執行下列命令，如果已安裝舊版，也會升級延伸模組：
```
az extension add --upgrade -n quantum
```
使用您的登入資訊來登入 Azure。您會看到與您的帳戶相關聯的訂用帳戶清單。
```
az login
```

指定要使用的訂用帳戶。

az account set -s <Your subscription ID>

如果這是您第一次在訂用帳戶中建立量子工作區，請使用下列命令來註冊資源提供者：
```
az provider register --namespace Microsoft.Quantum
```

建立 Azure Quantum 工作區

若要建立新的 Azure Quantum 工作區，您必須知道：

資源將會存留的位置或 Azure 區域名稱。您可以使用 Azure CLI 工具所支援的區域清單及其資源管理員代碼，例如 westus。
與新工作區相關聯的資源群組，例如 MyResourceGroup。
與量子工作區位於相同資源群組和訂用帳戶中的儲存體帳戶。您可以從 AZ CLI 工具建立新的儲存體帳戶，例如 MyStorageAccount。
所要建立量子工作區的名稱，例如 MyQuantumWorkspace。
要在工作區中使用的 Azure Quantum 提供者清單。提供者提供一組方案，每個方案都代表一個具有相關聯條款及條件、成本和配額的方案。若要建立工作區，您必須指定對應的方案與提供者，除非您想要從提供免費點數的提供者開始，否則它們會自動新增至您的工作區。

如果您已經知道要在工作區中使用的提供者和計畫名稱，您可以跳至下方的步驟 4。如果您想要從提供免費點數的提供者開始，您可以輸入下列命令：

az quantum workspace create \
   -l MyLocation \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyStorageAccount

系統可能會提示您接受使用規定。輸入 Y 以接受條款。請注意， -r 以下步驟 4 所示的參數並非必要。

如果您需要判斷要使用的提供者和計畫，請依照下列方式繼續進行：

若要擷取可用的量子提供者清單，請使用 list 命令 (此範例會使用 westus 做為位置)：
```
az quantum offerings list \
     -l westus \
     -o table
```
提示

如果您想要查看哪些提供者提供免費點數，請使用 --autoadd-only 參數，例如：
az quantum offerings list --autoadd-only -l westus -o table
如先前所述，這些提供者會自動新增至您的工作區。您不需要使用 -r 參數來指定它們。
一旦您決定要包含在工作區中的提供者和方案，您可以使用 show-terms 命令 (新增 MyProviderID 和 MyPlan 做為範例值) 來檢閱字詞：
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
show-terms 命令的輸出會包含一個布林值欄位 accepted，顯示是否已接受此提供者的項，以及要檢閱的授權條款連結。如果您決定接受這些條款，請使用 accept-terms 命令來記錄您的接受。
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
當您檢閱並接受所有必要的條款及條件之後，您可以使用 create 命令來建立工作區，並指定以逗號分隔的提供者和方案組合清單，如下列範例所示：
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

建立工作區之後，您仍然可以使用Azure 入口網站來新增或移除提供者。

變更量子工作區的預設儲存體帳戶

如果您需要變更現有工作區的預設儲存體帳戶，您可以使用 create 命令，並指定所有目前的屬性以及新的儲存體帳戶。下列範例會使用與上一個範例中建立之工作區相同的設定：

az quantum workspace create \
   -l westus \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyNEWStorageAccount \
   -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"

重要

此程式實際上會使用新的儲存體帳戶重新建立工作區。請確定儲存體帳戶以外的所有屬性與原始屬性完全相同，否則會建立第二個工作區。

刪除量子工作區

如果您知道想要刪除之量子工作區的名稱和資源群組，您可以使用與上一個範例相同的名稱 (命令來執行此 delete 動作) ：

az quantum workspace delete \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

提示

如果您不記得確切的名稱，可以使用 az quantum workspace list -o table 來檢視訂用帳戶中的整個量子工作區清單。

刪除工作區之後，在雲端中刪除工作區時仍會列出該工作區。但是，工作區的 provisioningState 屬性會立即變更，以指出其正在刪除。您可以使用 show 命令來查看這項資訊：

az quantum workspace show \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

注意

如果您先前使用過 az quantum workspace set 命令來指定預設的量子工作區，則您可以呼叫不含參數的 delete 命令來刪除 (並清除) 預設工作區。

az quantum workspace delete

後續步驟

既然您可以建立和刪除工作區，請瞭解在Azure Quantum 中執行量子演算法的不同 targets。