`%azure.connect`

아티클
02/09/2024

경고

이 설명서는 최신 QDK로 대체된 클래식 QDK를 참조합니다.

최신 QDK는 '%%qsharp' 매직 명령만 지원합니다.

요약

Azure Quantum 작업 영역에 연결하거나 현재 연결 상태를 표시합니다.

Description

이 매직 명령을 사용하면 작업 영역의 리소스 ID 및 위치 또는 구독 ID, 리소스 그룹 이름, 작업 영역 이름 및 위치의 조합으로 지정된 대로 Azure Quantum 작업 영역에 연결할 수 있습니다.

연결에 성공하면 Azure Quantum 작업 영역에서 사용 가능한 Q# 실행 대상 목록이 표시됩니다.

필수 매개 변수

Azure Quantum 작업 영역은 리소스 ID로 식별할 수 있습니다.

resourceId=<string>: Azure Quantum 작업 영역의 리소스 ID입니다. Azure Portal 작업 영역 페이지에서 가져올 수 있습니다. resourceId= 접두사는 리소스 ID가 유효한 한 이 매개 변수에 대해 선택 사항입니다.

또는 구독 ID, 리소스 그룹 이름 및 작업 영역 이름으로 식별할 수 있습니다.

subscription=<string>: Azure Quantum 작업 영역에 대한 Azure 구독 ID입니다.
resourceGroup=<string>: Azure Quantum 작업 영역의 Azure 리소스 그룹 이름입니다.
workspace=<string>: Azure Quantum 작업 영역의 이름입니다.

위의 식별자와 함께 유효한 위치가 필요합니다.

location=<string>: Azure Quantum 작업 영역이 프로비전되는 Azure 지역입니다. 지역 이름(예: 또는 과 같은 위치 이름)으로 "East US""eastus"지정할 수 있습니다.

선택적 매개 변수

storage=<string>: Azure Storage 계정에 대한 연결 문자열. 지정된 Azure Quantum 작업 영역이 작업 영역을 만들 때 스토리지 계정에 연결되지 않은 경우 필요합니다.
credential=<CredentialType>: Azure에서 인증하는 데 사용할 자격 증명 유형입니다. 참고: 인증을 위해 Azure ID 라이브러리를 활용합니다. 이 매개 변수를 기반으로 자격 증명 클래스의 instance 만듭니다. 가능한 옵션은 아래와 같습니다.
- Environment: 환경 변수에 지정된 자격 증명 정보를 통해 서비스 주체 또는 사용자를 인증합니다.
- ManagedIdentity: Azure 리소스의 관리 ID를 인증합니다.
- CLI: Azure CLI를 사용하여 개발 환경에서 인증합니다.
- SharedToken: Microsoft 애플리케이션 간에 공유되는 로컬 캐시에서 토큰을 사용하여 인증합니다.
- VisualStudio: Visual Studio의 데이터를 사용하여 인증합니다.
- VisualStudioCode: Visual Studio Code 사용하여 개발 환경에서 인증합니다.
- 대화형: 사용자를 대화형으로 인증하고 액세스 토큰을 가져오는 새 브라우저 창을 엽니다.
- DeviceCode: 디바이스 코드 흐름을 사용하여 액세스 토큰을 가져오는 사용자를 인증합니다. 제공되지 않으면 각 자격 증명 형식을 순서대로 시도하고 Azure에서 성공적으로 인증할 수 있는 첫 번째 자격 증명 형식을 선택합니다.

가능한 오류

WorkspaceNotFound: 지정된 조건과 일치하는 Azure Quantum 작업 영역을 찾을 수 없습니다.
AuthenticationFailed: 지정된 Azure Quantum 작업 영역에 인증하지 못했습니다.

에 대한 예제 `%azure.connect`

예 1

리소스 ID를 사용하여 '미국 서부' 지역에 Azure Quantum 작업 영역에 연결합니다.

In []: %azure.connect "/subscriptions/.../Microsoft.Quantum/Workspaces/WORKSPACE_NAME" location="West US"
Out[]: Connected to Azure Quantum workspace WORKSPACE_NAME in location westus.
        <list of Q# execution targets available in the Azure Quantum workspace>

예 2

리소스 ID, 스토리지 계정 연결 문자열 및 위치를 사용하여 Azure Quantum 작업 영역에 연결합니다.

In []: %azure.connect resourceId="/subscriptions/.../Microsoft.Quantum/Workspaces/WORKSPACE_NAME"
                      storage="STORAGE_ACCOUNT_CONNECTION_STRING"
                      location="East US"
Out[]: Connected to Azure Quantum workspace WORKSPACE_NAME in location eastus.
        <list of Q# execution targets available in the Azure Quantum workspace>

예제 3

브라우저를 사용하여 개별 구독 ID, 리소스 그룹 이름을 사용하여 Azure Quantum 작업 영역에 연결하여 Azure에서 사용자 자격 증명을 묻는 메시지를 표시합니다.

In []: %azure.connect subscription="SUBSCRIPTION_ID"
                      resourceGroup="RESOURCE_GROUP_NAME"
                      workspace="WORKSPACE_NAME"
                      location="West US"
                      credential="interactive"
Out[]: Connected to Azure Quantum workspace WORKSPACE_NAME in location westus.
        <list of Q# execution targets available in the Azure Quantum workspace>

예제 4

현재 연결된 Azure Quantum 작업 영역에 대한 정보를 인쇄합니다.

In []: %azure.connect
Out[]: Connected to Azure Quantum workspace WORKSPACE_NAME in location westus.
        <list of Q# execution targets available in the Azure Quantum workspace>

%azure.connect

요약