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

使用 Azure CLI 管理量子工作区

项目
04/02/2025

本指南介绍如何使用 Azure Command-Line 接口（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 提供程序列表。提供商提供了一组计划，每个计划都表示一个具有关联条款和条件、成本和配额的计划。若要创建工作区，需要与提供商一起指定相应的计划，除非你希望从提供免费额度的提供商开始，否则它们会自动添加到工作区。

如果你已经了解在工作区中要使用的提供程序和计划名称，则可以跳到下面的步骤四。如果要从提供免费额度的提供商开始，可以输入以下命令：

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"

重要

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

删除量子工作区

如果知道要删除的量子工作区的名称和资源组，可以使用 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

后续步骤

你现在可以创建和删除工作区，请了解其他 targets 以在 Azure Quantum 中运行量子算法。

通过