다음을 통해 공유

Instance Pools - Update

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

인스턴스 풀을 업데이트합니다.

PATCH 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
properties.licenseType True

InstancePoolLicenseType

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

string

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

integer (int32)

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

string (arm-id)

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

Sku

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

object

리소스 태그.

응답

Name 형식 Description
200 OK

InstancePool

인스턴스 풀을 업데이트했습니다.
202 Accepted

허용

헤더

Location: string
Other Status Codes

ErrorResponse

오류 응답: ***

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

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

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

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

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

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

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

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

  • 400 InvalidResourceRequestBody - 요청 본문의 리소스 또는 리소스 속성이 비어 있거나 잘못되었습니다.

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.

  • 409 OperationCancelled - 사용자가 작업을 취소했습니다.

  • 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.

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

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

  • 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.

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

예제

Patch an instance pool

샘플 요청

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

{
  "tags": {
    "x": "y"
  }
}

샘플 응답

상태 코드:
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",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"
  },
  "location": "japaneast",
  "tags": {
    "x": "y"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}
상태 코드:
202 
Location: https://management.azure.com/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/instancepoolazureasyncoperation/00000000-1111-2222-3333-444444444444?api-version=2022-11-01-preview

정의

Name Description
ErrorAdditionalInfo

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

오류 세부 정보입니다.
ErrorResponse

오류 응답
InstancePool

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

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

인스턴스 풀에 대한 업데이트입니다.
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

InstancePoolUpdate

Object

인스턴스 풀에 대한 업데이트입니다.

Name 형식 Description
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

리소스 태그.

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