Virtual Clusters - Update

Service:

SQL Database

API Version:

2021-11-01

Atualizações um cluster virtual.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
virtualClusterName	path	True	string	O nome do cluster virtual.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Tipo	Description
properties.family	string	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.
properties.maintenanceConfigurationId	string	Especifica o ID de configuração de manutenção a aplicar a este cluster virtual.
tags	object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	VirtualCluster	O cluster virtual foi atualizado com êxito.
202 Accepted		A atualização do cluster virtual está em curso.
Other Status Codes		Respostas de Erro: *** 400 SubscriptionNotEnabledForFeature - Subscrição de utilizador não ativada para a funcionalidade que o utilizador tentou utilizar. 400 ManagementServiceFeatureDisabled – o utilizador tentou utilizar uma funcionalidade que está desativada. 400 InvalidMaintenanceWindowSettings – Definições de janela de manutenção inválidas. 400 InvalidMaintenanceWindowProperty – foi especificada a propriedade da janela de manutenção inválida. 400 InvalidMaintenanceWindowPropertyNull - Janela de manutenção inválida com propriedades necessárias nula. 400 InvalidMaintenanceWindowTypeWithPropertySpecified - O tipo de janela de manutenção não pode ter determinadas propriedades especificadas. 400 UpdateOfParameterNotSupported - A atualização de "{0}" não é suportada. 404 VirtualClusterDoesNotExist – O cluster virtual não existe. 404 ResourceDoesNotExist – o recurso com o nome "{0}" não existe. Para continuar, especifique um nome de recurso válido. 404 VirtualClusterNotInSubscriptionResourceGroup - O cluster virtual especificado não existe no grupo de recursos e na subscrição especificados. 404 SubscriptionNotFound - A subscrição pedida não foi encontrada. 404 SubscriptionDoesNotHaveVirtualCluster - O cluster virtual pedido não foi encontrado 404 ResourceNotFound – o recurso pedido não foi encontrado. 404 OperationIdNotFound - A operação com o ID não existe. 409 VirtualClusterRemovalAlreadyInProgress – A remoção do cluster virtual já está em curso. O cluster virtual é criado automaticamente com a criação da primeira instância e removido automaticamente com a eliminação da última instância. Saiba mais aqui: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty – O cluster virtual não está vazio e não pode ser eliminado. 409 VirtualClusterIsBusy – O cluster virtual está atualmente ocupado. Repita a operação mais tarde. 409 VirtualClusterRemovalFailed – O pedido para remover o cluster virtual falhou. Verifique se existem recursos dependentes ativos. 409 ConflictingVirtualClusterOperation - Está atualmente em curso uma operação para o cluster virtual. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 ConflictingSubscriptionOperation - Está em curso uma operação para a subscrição. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Exemplos

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

Definições

Name	Description
VirtualCluster	Um cluster virtual SQL do Azure.
VirtualClusterUpdate	Um pedido de atualização para um cluster virtual da Base de Dados SQL do Azure.

VirtualCluster

Um cluster virtual SQL do Azure.

Name	Tipo	Description
id	string	ID do Recurso.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.childResources	string[]	Lista de recursos neste cluster virtual.
properties.family	string	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.
properties.maintenanceConfigurationId	string	Especifica o ID de configuração de manutenção a aplicar a este cluster virtual.
properties.subnetId	string	ID de recurso da sub-rede para o cluster virtual.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

VirtualClusterUpdate

Um pedido de atualização para um cluster virtual da Base de Dados SQL do Azure.

Name	Tipo	Description
properties.childResources	string[]	Lista de recursos neste cluster virtual.
properties.family	string	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.
properties.maintenanceConfigurationId	string	Especifica o ID de configuração de manutenção a aplicar a este cluster virtual.
properties.subnetId	string	ID de recurso da sub-rede para o cluster virtual.
tags	object	Etiquetas de recursos.