Instance Pools - List

서비스:

SQL Database

API 버전:

2023-08-01

구독의 모든 인스턴스 풀 목록을 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	InstancePoolListResult	구독의 인스턴스 풀 목록을 성공적으로 검색했습니다.
Other Status Codes	ErrorResponse	오류 응답: *** 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

List instance pools in the subscription

샘플 요청

HTTP

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

샘플 응답

상태 코드:

200

{
  "value": [
    {
      "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"
    },
    {
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "family": "Gen5"
      },
      "properties": {
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group2/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/group2/providers/Microsoft.Sql/instancePools/testIP2",
      "name": "testIP2",
      "type": "Microsoft.Sql/instancePools"
    }
  ]
}

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
InstancePool	Azure SQL 인스턴스 풀입니다.
InstancePoolLicenseType	라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(SQL 라이선스 가격이 포함됨) 및 'BasePrice'(SQL 라이선스 가격 제외)입니다.
InstancePoolListResult	Azure 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

InstancePoolListResult

Object

Azure SQL 인스턴스 풀 목록입니다.

Name	형식	Description
nextLink	string	결과의 다음 페이지를 검색하는 링크입니다.
value	InstancePool[]	결과 배열입니다.

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)입니다.