Virtual Clusters - Update

Service:

SQL Database

API Version:

2021-11-01

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

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
virtualClusterName	path	True	string	가상 클러스터의 이름입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties.family	string	서비스에 동일한 SKU에 대해 서로 다른 세대의 하드웨어가 있는 경우 여기에서 캡처할 수 있습니다.
properties.maintenanceConfigurationId	string	이 가상 클러스터에 적용할 유지 관리 구성 ID를 지정합니다.
tags	object	리소스 태그.

응답

Name	형식	Description
200 OK	VirtualCluster	가상 클러스터를 업데이트했습니다.
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 - 요청된 리소스를 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 VirtualClusterRemovalAlreadyInProgress - 가상 클러스터 제거가 이미 진행 중입니다. 가상 클러스터는 처음 instance 만들어지고 마지막 instance 삭제되면 자동으로 제거됩니다. 여기(https://aka.ms/sqlmi-virtual-cluster-removal)에서 자세히 알아보세요. 409 VirtualClusterIsNotEmpty - 가상 클러스터가 비어 있지 않으므로 삭제할 수 없습니다. 409 VirtualClusterIsBusy - 가상 클러스터가 현재 사용 중입니다. 나중에 작업을 다시 시도하세요. 409 VirtualClusterRemovalFailed - 가상 클러스터 삭제 요청이 실패했습니다. 활성 종속 리소스가 있는지 확인합니다. 409 ConflictingVirtualClusterOperation - 현재 가상 클러스터에 대한 작업이 진행 중입니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 ConflictingSubscriptionOperation - 현재 구독에 대한 작업이 진행 중입니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Update virtual cluster with tags

Sample Request

HTTP

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=2021-11-01

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.VirtualClusterUpdate;

/** Samples for VirtualClusters Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/VirtualClusterUpdate.json
     */
    /**
     * Sample code: Update virtual cluster with tags.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateVirtualClusterWithTags(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getVirtualClusters().update("testrg",
            "vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
            new VirtualClusterUpdate().withMaintenanceConfigurationId(
                "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "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"
}

Status code:

202

정의

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

VirtualCluster

Azure SQL 가상 클러스터.

Name	형식	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	형식	Description
properties.childResources	string[]	이 가상 클러스터의 리소스 목록입니다.
properties.family	string	서비스에 동일한 SKU에 대해 서로 다른 세대의 하드웨어가 있는 경우 여기에서 캡처할 수 있습니다.
properties.maintenanceConfigurationId	string	이 가상 클러스터에 적용할 유지 관리 구성 ID를 지정합니다.
properties.subnetId	string	가상 클러스터의 서브넷 리소스 ID입니다.
tags	object	리소스 태그.