다음을 통해 공유

Instance Pools - Get

서비스:
SQL Database
API 버전:
2023-08-01

인스턴스 풀을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}?api-version=2023-08-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
instancePoolName
 path True

string

검색할 인스턴스 풀의 이름입니다.
resourceGroupName
 path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
subscriptionId
 path True

string

Azure 구독을 식별하는 구독 ID입니다.
api-version
 query True

string

요청에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

InstancePool

지정된 인스턴스 풀을 성공적으로 검색했습니다.
Other Status Codes

ErrorResponse

오류 응답: ***

  • 400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다.

  • 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다.

  • 400 InvalidMinimalTlsVersion - 최소 TLS 버전이 잘못되었습니다.

  • 400 InvalidResourceId - 잘못된 리소스 식별자입니다.

  • 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다.

  • 400 DeleteOfManagedInstanceIsDisabled - 관리되는 인스턴스의 삭제 작업을 사용할 수 없습니다.

  • 400 CustomMaintenanceWindowIsDisabled - 사용자 지정 유지 관리 기간을 사용할 수 없습니다.

  • 400 MICantBeMovedFromOrToInstancePool - 기존 관리형 인스턴스는 관리되는 인스턴스 풀로 이동할 수 없습니다.

  • 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다.

  • 404 InstancePoolNotFound - 인스턴스 풀을 찾을 수 없음

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Get an instance pool

샘플 요청

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP?api-version=2023-08-01

샘플 응답

상태 코드:
200 
{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded",
    "dnsZone": "1234567890",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"
  },
  "location": "japaneast",
  "tags": {
    "a": "b"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}

정의

Name Description
ErrorAdditionalInfo

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

오류 세부 정보입니다.
ErrorResponse

오류 응답
InstancePool

Azure SQL 인스턴스 풀입니다.
InstancePoolLicenseType

라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(SQL 라이선스 가격이 포함됨) 및 'BasePrice'(SQL 라이선스 가격 제외)입니다.
Sku

ARM 리소스 SKU입니다.

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

오류 개체입니다.

InstancePool

Object

Azure SQL 인스턴스 풀입니다.

Name 형식 Description
id

string

리소스 ID입니다.
location

string

리소스 위치입니다.
name

string

리소스 이름입니다.
properties.dnsZone

string

관리되는 인스턴스 풀이 있는 Dns 영역입니다.
properties.licenseType

InstancePoolLicenseType

라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(SQL 라이선스 가격이 포함됨) 및 'BasePrice'(SQL 라이선스 가격 제외)입니다.
properties.maintenanceConfigurationId

string (arm-id)

이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다.
properties.subnetId

string

이 인스턴스 풀을 배치할 서브넷의 리소스 ID입니다.
properties.vCores

integer (int32)

이 인스턴스 풀에 속하는 vCore의 수입니다.
sku

Sku

SKU의 이름 및 계층입니다.
tags

object

리소스 태그.
type

string

리소스 종류입니다.

InstancePoolLicenseType

열거형

라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(SQL 라이선스 가격이 포함됨) 및 'BasePrice'(SQL 라이선스 가격 제외)입니다.

값 Description
LicenseIncluded
BasePrice

Sku

Object

ARM 리소스 SKU입니다.

Name 형식 Description
capacity

integer (int32)

특정 SKU의 용량입니다.
family

string

서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.
name

string

SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다.
size

string

특정 SKU의 크기
tier

string

특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다.