Virtual Clusters - Update

가상 클러스터를 업데이트.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/virtualClusters/{virtualClusterName}?api-version=2022-02-01-preview

URI 매개 변수

Name In Required Type Description
resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

Azure 구독을 식별하는 구독 ID입니다.

virtualClusterName
path True
  • string

가상 클러스터의 이름입니다.

api-version
query True
  • string

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

요청 본문

Name Type Description
properties.family
  • string

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

properties.maintenanceConfigurationId
  • string

이 가상 클러스터에 적용할 유지 관리 구성 ID를 지정합니다.

tags
  • object

리소스 태그.

응답

Name Type Description
200 OK

가상 클러스터를 성공적으로 업데이트했습니다.

202 Accepted

가상 클러스터 업데이트가 진행 중입니다.

Other Status Codes

오류 응답: ***

  • 400 SubscriptionNotEnabledForFeature - 사용하려는 기능 사용자가 사용자 구독을 사용할 수 없습니다.

  • 400 ManagementServiceFeatureDisabled - 사용자가 사용하지 않도록 설정된 기능을 사용하려고 했습니다.

  • 400 InvalidMaintenanceWindowSettings - 잘못된 유지 관리 기간 설정입니다.

  • 400 InvalidMaintenanceWindowProperty - 잘못된 유지 관리 기간 속성이 지정되었습니다.

  • 400 InvalidMaintenanceWindowPropertyNull - 필수 속성이 null인 잘못된 유지 관리 기간입니다.

  • 400 InvalidMaintenanceWindowTypeWithPropertySpecified - 유지 관리 기간 유형에 지정된 특정 속성이 없어야 합니다.

  • 400 UpdateOfParameterNotSupported - '{0}' 업데이트는 지원되지 않습니다.

  • 404 VirtualClusterDoesNotExist - 가상 클러스터가 없습니다.

  • 404 ResourceDoesNotExist - 이름이 '{0}'인 리소스가 없습니다. 계속하려면 유효한 리소스 이름을 지정합니다.

  • 404 VirtualClusterNotInSubscriptionResourceGroup - 지정된 가상 클러스터가 지정된 리소스 그룹 및 구독에 없습니다.

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

  • 404 SubscriptionDoesNotHaveVirtualCluster - 요청된 가상 클러스터를 찾을 수 없습니다.

  • 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.

  • 409 VirtualClusterRemovalAlreadyInProgress - 가상 클러스터 제거가 이미 진행 중입니다. 가상 클러스터는 첫 번째 인스턴스를 만들 때 자동으로 만들어지고 마지막 인스턴스 삭제와 함께 자동으로 제거됩니다. 자세한 내용은 다음을 참조하세요 https://aka.ms/sqlmi-virtual-cluster-removal.

  • 409 VirtualClusterIsNotEmpty - 가상 클러스터가 비어 있지 않으므로 삭제할 수 없습니다.

  • 409 VirtualClusterIsBusy - 가상 클러스터가 현재 사용 중입니다. 나중에 작업을 다시 시도하세요.

  • 409 VirtualClusterRemovalFailed - 가상 클러스터 삭제 요청이 실패했습니다. 활성 종속 리소스가 있는지 확인합니다.

  • 409 ConflictingVirtualClusterOperation - 현재 가상 클러스터에 대한 작업이 진행 중입니다.

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

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

  • 429 ConflictingSubscriptionOperation - 현재 구독에 대한 작업이 진행 중입니다.

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

예제

Update virtual cluster with tags

Sample Request

PATCH https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2?api-version=2022-02-01-preview

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"
  }
}

Sample Response

{
  "properties": {
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "childResources": [
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance1",
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance2"
    ],
    "maintenanceConfigurationId": "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"
  },
  "location": "onebox",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "name": "vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "type": "Microsoft.Sql/virtualClusters"
}

정의

VirtualCluster

Azure SQL 가상 클러스터입니다.

VirtualClusterUpdate

Azure SQL Database 가상 클러스터에 대한 업데이트 요청입니다.

VirtualCluster

Azure SQL 가상 클러스터입니다.

Name Type Description
id
  • string

리소스 ID입니다.

location
  • string

리소스 위치.

name
  • string

리소스 이름입니다.

properties.childResources
  • string[]

이 가상 클러스터의 리소스 목록입니다.

properties.family
  • string

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

properties.maintenanceConfigurationId
  • string

이 가상 클러스터에 적용할 유지 관리 구성 ID를 지정합니다.

properties.subnetId
  • string

가상 클러스터의 서브넷 리소스 ID입니다.

tags
  • object

리소스 태그.

type
  • string

리소스 종류.

VirtualClusterUpdate

Azure SQL Database 가상 클러스터에 대한 업데이트 요청입니다.

Name Type Description
properties.childResources
  • string[]

이 가상 클러스터의 리소스 목록입니다.

properties.family
  • string

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

properties.maintenanceConfigurationId
  • string

이 가상 클러스터에 적용할 유지 관리 구성 ID를 지정합니다.

properties.subnetId
  • string

가상 클러스터의 서브넷 리소스 ID입니다.

tags
  • object

리소스 태그.