Workspaces - Get

서비스:: Azure Quantum

API 버전:: 2025-12-15-preview

지정된 이름과 연결된 작업 영역 리소스를 반환합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}?api-version=2025-12-15-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	양자 작업 영역 리소스의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	QuantumWorkspace	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Workspaces_Get

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/quantumResourcegroup/providers/Microsoft.Quantum/workspaces/quantumworkspace1?api-version=2025-12-15-preview

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/quantumResourcegroup/providers/Microsoft.Quantum/Workspaces/quantumworkspace1",
  "name": "quantumworkspace1",
  "type": "Microsoft.Quantum/Workspaces",
  "properties": {
    "providers": [
      {
        "providerId": "Honeywell",
        "providerSku": "Basic",
        "applicationName": "quantumworkspace1-h1",
        "instanceUri": "https://h1.endpoint.com",
        "provisioningState": "Succeeded",
        "resourceUsageId": "00000000-1111-2222-3333-444444444444"
      },
      {
        "providerId": "IonQ",
        "provisioningState": "Succeeded",
        "applicationName": "quantumworkspace1-i1",
        "instanceUri": "https://i1.endpoint.com",
        "providerSku": "Basic",
        "resourceUsageId": "00000000-1111-2222-3333-444444444444"
      },
      {
        "providerId": "OneQBit",
        "provisioningState": "Succeeded",
        "applicationName": "quantumworkspace1-o1",
        "instanceUri": "https://o1.endpoint.com",
        "providerSku": "Basic",
        "resourceUsageId": "00000000-1111-2222-3333-444444444444"
      },
      {
        "providerId": "suiteProvider",
        "provisioningState": "Succeeded",
        "applicationName": "quantumworkspace1-s1",
        "instanceUri": "https://s1.endpoint.com",
        "providerSku": "Basic",
        "resourceUsageId": "00000000-1111-2222-3333-444444444444",
        "quotas": {
          "standardMinutesLifetime": 500,
          "highMinutesLifetime": 50
        }
      }
    ],
    "provisioningState": "Succeeded",
    "usable": "Yes",
    "storageAccount": "/subscriptions/1C4B2828-7D49-494F-933D-061373BE28C2/resourceGroups/quantumResourcegroup/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
    "workspaceKind": "V1",
    "endpointUri": "https://quantumworkspace1.westus.quantum.azure.com",
    "apiKeyEnabled": true
  },
  "location": "West US",
  "tags": {
    "department": "MightyMight",
    "company": "Contoso"
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-1111-2222-3333-444444444444",
    "tenantId": "00000000-1111-2222-3333-444444444444"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  }
}

정의

Name	Description
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ManagedOnBehalfOfConfiguration	Managed-On-Behalf-Of 구성 속성입니다. 이 구성은 리소스 공급자가 리소스 소유자를 대신하여 해당 리소스를 관리하는 리소스에 대해 존재합니다.
ManagedServiceIdentity	관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)
ManagedServiceIdentityType	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
MoboBrokerResource	Managed-On-Behalf-Of 브로커 리소스입니다. 이 리소스는 리소스 공급자가 사용자를 대신하여 일부 리소스를 관리하기 위해 만듭니다.
Provider	공급자에 대한 정보. 공급자는 Azure Quantum 작업을 실행하기 위한 대상을 제공하는 엔터티입니다.
ProviderStatus	프로비전 상태 필드
QuantumWorkspace	Quantum Workspace에 대한 리소스 프록시 정의 개체입니다.
QuotaAllocations	각 필드가 서로 다른 할당량 유형을 나타내는 할당량 할당입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UsableStatus	현재 작업 영역이 작업을 수락할 준비가 되었는지 여부입니다.
UserAssignedIdentity	사용자 할당 ID 속성
WorkspaceKind	작업 영역 형식입니다.
WorkspaceProvisioningStatus	작업 영역 프로비저닝 상태입니다.
WorkspaceResourceProperties	작업공간의 속성

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

ManagedOnBehalfOfConfiguration

Object

Managed-On-Behalf-Of 구성 속성입니다. 이 구성은 리소스 공급자가 리소스 소유자를 대신하여 해당 리소스를 관리하는 리소스에 대해 존재합니다.

Name	형식	Description
moboBrokerResources	MoboBrokerResource[]	Managed-On-Behalf-Of 브로커 리소스

ManagedServiceIdentity

Object

관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)

Name	형식	Description
principalId	string (uuid)	시스템 할당 ID의 서비스 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
tenantId	string (uuid)	시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
type	ManagedServiceIdentityType	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned ID 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

ManagedServiceIdentityType

열거형

관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).

값	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MoboBrokerResource

Object

Managed-On-Behalf-Of 브로커 리소스입니다. 이 리소스는 리소스 공급자가 사용자를 대신하여 일부 리소스를 관리하기 위해 만듭니다.

Name	형식	Description
id	string (arm-id)	Managed-On-Behalf-Of 브로커 리소스의 리소스 식별자

Provider

Object

공급자에 대한 정보. 공급자는 Azure Quantum 작업을 실행하기 위한 대상을 제공하는 엔터티입니다.

Name	형식	Description
applicationName	string	공급자의 마켓플레이스 애플리케이션 표시 이름입니다.
instanceUri	string	이 공급자의 특정 인스턴스를 식별하는 URI입니다.
providerId	string	이 공급자의 고유 ID입니다.
providerSku	string	이 공급자의 가격 책정 정보와 연결된 sku입니다.
provisioningState	ProviderStatus	프로비전 상태 필드
quotas	QuotaAllocations	이 제공자와 관련된 할당량. 특별 제공자만 사용할 수 있습니다.
resourceUsageId	string	공급자의 리소스 사용량을 추적하는 ID입니다.

ProviderStatus

열거형

프로비전 상태 필드

값	Description
Succeeded	공급자가 성공적으로 프로비전되었습니다.
Launching	공급자가 프로비저닝을 시작합니다.
Updating	공급자가 업데이트 중입니다.
Deleting	공급자가 삭제 중입니다.
Deleted	공급자가 삭제됩니다.
Failed	공급자가 실패했습니다.

QuantumWorkspace

Object

Quantum Workspace에 대한 리소스 프록시 정의 개체입니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	이 리소스에 할당된 관리 서비스 ID입니다.
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties	WorkspaceResourceProperties	속성을 가져오거나 설정합니다. 양자 작업 영역의 특정 속성을 정의합니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

QuotaAllocations

Object

각 필드가 서로 다른 할당량 유형을 나타내는 할당량 할당입니다.

Name	형식	Description
highMinutesLifetime	integer (int32) minimum: 0	우선 순위가 높은 작업 실행에 대한 수명 제한(분)입니다.
standardMinutesLifetime	integer (int32) minimum: 0	표준 우선 순위 작업 실행에 대한 수명 제한(분)입니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

UsableStatus

열거형

현재 작업 영역이 작업을 수락할 준비가 되었는지 여부입니다.

값	Description
Yes	작업 영역을 사용할 수 있으며 작업을 수락할 수 있습니다.
No	작업 영역을 사용할 수 없으며 작업을 수락할 수 없습니다.
Partial	작업 영역을 부분적으로 사용할 수 있습니다.

UserAssignedIdentity

Object

사용자 할당 ID 속성

Name	형식	Description
clientId	string (uuid)	할당된 ID의 클라이언트 ID입니다.
principalId	string (uuid)	할당된 ID의 보안 주체 ID입니다.

WorkspaceKind

열거형

작업 영역 형식입니다.

값	Description
V1	작업 영역은 범용 작업 영역입니다.
V2	작업 영역은 V2 작업 영역입니다.

WorkspaceProvisioningStatus

열거형

작업 영역 프로비저닝 상태입니다.

값	Description
Succeeded	작업 영역 프로비저닝이 성공했습니다.
Failed	작업 영역 프로비저닝에 실패했습니다.
Canceled	리소스 만들기가 취소되었습니다.
ProviderLaunching	작업 영역은 현재 공급자를 프로비전하기 시작했습니다.
ProviderUpdating	작업 영역은 현재 공급자를 업데이트하고 있습니다.
ProviderDeleting	작업 영역은 현재 공급자를 삭제하고 있습니다.
ProviderProvisioning	작업 영역은 현재 공급자를 프로비저닝하고 있습니다.

WorkspaceResourceProperties

Object

작업공간의 속성

Name	형식	Description
apiKeyEnabled	boolean	Quantum 작업 영역 API 키의 사용 표시기입니다.
endpointUri	string	작업 영역 끝점의 URI입니다.
managedOnBehalfOfConfiguration	ManagedOnBehalfOfConfiguration	대신 관리됨 구성.
managedStorageAccount	string (arm-id)	이 작업 영역과 연결된 관리되는 스토리지 계정의 ARM 리소스 ID입니다.
providers	Provider[]	이 작업 영역에 대해 선택된 공급자 목록
provisioningState	WorkspaceProvisioningStatus	프로비전 상태 필드
storageAccount	string (arm-id)	이 작업 영역과 연결된 스토리지 계정의 ARM 리소스 ID입니다.
usable	UsableStatus	현재 작업 영역이 작업을 수락할 준비가 되었는지 여부입니다.
workspaceKind	WorkspaceKind	이 작업 영역이 V1인지 V2인지 여부입니다.