你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
virtualClusterName	path	True	string	虚拟群集的名称。
api-version	query	True	string	要用于请求的 API 版本。

请求正文

名称	类型	说明
properties.family	string	如果服务具有不同代系的硬件（对于同一 SKU），则可以在此处进行捕获。
properties.maintenanceConfigurationId	string	指定要应用于此虚拟群集的维护配置 ID。
tags	object	资源标记。

响应

名称	类型	说明
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 - 删除虚拟群集已在进行中。虚拟群集在创建第一个实例时自动创建，并在上次删除实例时自动删除。在此处了解详细信息：https://aka.ms/sqlmi-virtual-cluster-removal。 409 VirtualClusterIsNotEmpty - 虚拟群集不为空，无法删除。 409 VirtualClusterIsBusy - 虚拟群集当前正忙。请稍后重试操作。 409 VirtualClusterRemovalFailed - 删除虚拟群集的请求失败。检查是否存在活动的依赖资源。 409 ConflictingVirtualClusterOperation - 虚拟群集当前正在进行操作。 409 OperationCancelled - 用户已取消该操作。 409 操作中断 - 无法完成对资源的操作，因为它被同一资源上的另一个操作中断。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。 429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。 429 ConflictingSubscriptionOperation - 订阅的操作当前正在进行中。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。 429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。 500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。 503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。 503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。

名称

类型

说明

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 - 删除虚拟群集已在进行中。虚拟群集在创建第一个实例时自动创建，并在上次删除实例时自动删除。在此处了解详细信息：https://aka.ms/sqlmi-virtual-cluster-removal。
409 VirtualClusterIsNotEmpty - 虚拟群集不为空，无法删除。
409 VirtualClusterIsBusy - 虚拟群集当前正忙。请稍后重试操作。
409 VirtualClusterRemovalFailed - 删除虚拟群集的请求失败。检查是否存在活动的依赖资源。
409 ConflictingVirtualClusterOperation - 虚拟群集当前正在进行操作。
409 OperationCancelled - 用户已取消该操作。
409 操作中断 - 无法完成对资源的操作，因为它被同一资源上的另一个操作中断。
429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。
429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。
429 ConflictingSubscriptionOperation - 订阅的操作当前正在进行中。
429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。
429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。
500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。
503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。
503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。

示例

Update virtual cluster with tags

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


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

定义

名称	说明
VirtualCluster	Azure SQL虚拟群集。
VirtualClusterUpdate	Azure SQL数据库虚拟群集的更新请求。

VirtualCluster

Azure SQL虚拟群集。

名称	类型	说明
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数据库虚拟群集的更新请求。

名称	类型	说明
properties.childResources	string[]	此虚拟群集中的资源列表。
properties.family	string	如果服务具有不同代系的硬件（对于同一 SKU），则可以在此处进行捕获。
properties.maintenanceConfigurationId	string	指定要应用于此虚拟群集的维护配置 ID。
properties.subnetId	string	虚拟群集的子网资源 ID。
tags	object	资源标记。

Virtual Clusters - Update

URI 参数

请求正文

响应

示例

Update virtual cluster with tags

Sample Request

Sample Response

定义

VirtualCluster

VirtualClusterUpdate

其他资源