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

连接到 Azure Quantum 工作区的不同方法

项目
03/29/2024

创建 Azure Quantum 工作区后，可以连接到它并使用 Python 包提交代码 azure-quantum 。包azure-quantum提供表示 Workspace Azure Quantum 工作区的类。

有关访问工作区的其他方法，请参阅使用服务主体进行身份验证或使用托管标识进行身份验证。

先决条件

具有活动订阅的 Azure 帐户。如果没有 Azure 帐户，请免费注册并注册即用即付订阅。
Azure Quantum 工作区。请参阅创建 Azure Quantum 工作区。
最新版本的 Azure Quantum azure-quantum 包。
```
python -m pip install --upgrade azure-quantum
```
如果使用 Azure CLI，则必须具有最新版本。有关安装说明，请参阅：

使用连接字符串连接

可以使用连接字符串指定 Azure Quantum 工作区的连接参数。在以下情况下，可以使用连接字符串：

你希望与没有 Azure 帐户的其他人共享工作区访问权限。
你希望在有限的时间内与他人共享工作区访问权限。
由于公司策略，无法使用Microsoft Entra ID。

提示

每个 Azure Quantum 工作区都有 主密钥和辅助 密钥及其相应的连接字符串。如果希望允许其他人访问工作区，可以共享辅助密钥，并将主密钥用于自己的服务。这样，就可以根据需要替换辅助密钥，而不会在自己的服务中停机。有关共享工作区访问权限的详细信息，请参阅共享工作区访问权限。

复制连接字符串

登录到 Azure 门户并选择你的 Azure Quantum 工作区。
在左侧面板上，导航到 “操作 > 访问密钥”。
必须启用访问密钥。如果禁用了访问密钥，则需要先启用它们。请参阅管理访问密钥中的操作方法。
单击“复制”图标以复制连接字符串。可以选择主要或辅助连接字符串。

警告

以明文形式存储帐户访问密钥或连接字符串会带来安全风险，不建议这样做。以加密格式存储帐户密钥，或迁移应用程序以使用Microsoft Entra授权访问 Azure Quantum 工作区。

使用连接字符串访问 Azure Quantum 工作区

复制连接字符串后，即可使用它连接到 Azure Quantum 工作区。

Python
VS Code

如果使用的是 Python 环境，则可以创建对象 Workspace 以连接到 Azure Quantum 工作区。创建 Workspace 对象时，有两个选项用于标识 Azure Quantum 工作区。

可以通过调用 from_connection_string来创建Workspace对象。

# Creating a new Workspace object from a connection string 
from azure.quantum import Workspace 

connection_string = "[Copy connection string]" 
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

如果不想在代码中复制连接字符串，还可以将连接字符串存储在环境变量中并使用 Workspace()。

# Using environment variable to connect with  connection string

connection_string = "[Copy connection string]" 

import os 

os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

from azure.quantum import Workspace 

workspace = Workspace() 
print(workspace.get_targets())

有关如何启用/禁用和重新生成密钥的详细信息，请参阅管理访问密钥。

重要

禁用访问密钥后，使用连接字符串或访问密钥的所有请求均未授权。你仍然可以使用工作区参数连接到工作区。

使用工作区参数进行连接

每个 Azure Quantum 工作区都有一组唯一的参数，可用于连接到它。可以使用以下参数连接到 Azure Quantum 工作区：

参数	说明
`subscription_id`	Azure 订阅 ID。
`resource_group`	Azure 资源组名称。
`name`	Azure Quantum 工作区的名称。
`location`	预配 Azure Quantum 工作区的 Azure 区域。这可以指定为区域名称（例如“美国东部”）或位置名称（如“eastus”。
`resource_id`	Azure Quantum 工作区的 Azure 资源 ID。

可以在 Azure 门户的 Azure Quantum 工作区概述中找到工作区参数。

登录到 Azure 帐户、 https://portal.azure.com
选择 Azure Quantum 工作区，然后导航到 “概述”。
复制字段中的参数。

创建对象 Workspace 以连接到 Azure Quantum 工作区。创建 Workspace 对象时，有两个选项用于标识 Azure Quantum 工作区。

可以 (建议) 指定位置和资源 ID：

from azure.quantum import Workspace 

workspace = Workspace(  
    resource_id = "", # Add the resource ID of your workspace
    location = "" # Add the location of your workspace (for example "westus")
    )

可以指定位置、订阅 ID、资源组和工作区名称：

from azure.quantum import Workspace 

workspace = Workspace(  
    subscription_id = "", # Add the subscription ID of your workspace
    resource_group = "", # Add the resource group of your workspace
    workspace_name = "", # Add the name of your workspace
    location = "" # Add the location of your workspace (for example "westus")
    )

可以使用 Azure Command-Line 接口 (Azure CLI) 来连接工作区。有关详细信息，请参阅使用 Azure CLI 管理量子工作区。

使用 Azure CLI 登录到 Azure 帐户。
```
az login
```
选择要使用的订阅。使用你的订阅名称替换 SubscriptionName。也可以使用订阅 ID 替换订阅名称。
```
az account set --subscription SubscriptionName
```
设置要使用的工作区。将、 ResourceGroupName和 WorkspaceName 分别替换为WorkspaceLocation工作区位置、资源组名称和工作区名称。
```
az quantum workspace set --location WorkspaceLocation --resource-group ResourceGroupName --workspace-name WorkspaceName
```