你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure CLI 管理 Quantum 工作区

项目
08/19/2024

本指南介绍如何使用 Azure 命令行接口 (Azure CLI) 创建 Azure Quantum 工作区以及所需的资源组和存储帐户，并开始在 Azure Quantum 中运行量子应用程序。

先决条件

若要使用 Azure Quantum 服务，需要：

具有活动订阅的 Azure 帐户。如果没有 Azure 帐户，请免费注册并注册即用即付订阅。
量子工作区所在的 Azure 资源组。
要与 Quantum 工作区关联的资源组中的存储帐户。多个工作区可与同一帐户关联。
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 以接受条款。请注意，下面的步骤 4 中显示的 -r 参数不是必需的。

如果需要确定要使用哪些提供商和计划，请按如下所述继续操作：

若要检索可用量子提供程序的列表，请使用 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"

重要

此过程实际上是使用新的存储帐户重新创建工作区。确保存储帐户以外的所有属性都与原始属性完全相同，否则会创建第二个工作区。

删除 Quantum 工作区

如果知道要删除的量子工作区的名称和资源组，可使用 delete 命令执行此操作（使用与前面的示例相同的名称）：

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

提示

如果不记得确切的名称，可使用 az quantum workspace list -o table 查看订阅中的 Quantum 工作区的完整列表。

删除工作区后，在云中删除工作区时仍会列出该工作区。但是工作区的 provisioningState 属性会立即更改，以指示正在删除工作区。可使用 show 命令查看此信息：

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

注意

如果以前使用过 az quantum workspace set 命令来指定默认的量子工作区，则可以调用不带参数的 delete 命令来删除（并清除）默认工作区。

az quantum workspace delete

后续步骤

现在，可以创建和删除工作区，请了解在 Azure Quantum 中运行量子算法的不同targets方法。

通过