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 de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
virtualClusterName	path	True	string	O nome do cluster virtual.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Tipo	Description
properties.family	string	Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui.
properties.maintenanceConfigurationId	string	Especifica a ID de configuração de manutenção a ser aplicada a esse cluster virtual.
tags	object	Marcas de recurso.

Respostas

Nome	Tipo	Description
200 OK	VirtualCluster	O cluster virtual foi atualizado com êxito.
202 Accepted		A atualização do cluster virtual está em andamento.
Other Status Codes		Respostas de erro: *** 400 SubscriptionNotEnabledForFeature - Assinatura de usuário não habilitada para o usuário do recurso que tentou usar. 400 ManagementServiceFeatureDisabled - O usuário tentou usar um recurso que está desabilitado. 400 InvalidMaintenanceWindowSettings – Configurações inválidas da janela de manutenção. 400 InvalidMaintenanceWindowProperty - A propriedade de janela de manutenção inválida foi especificada. 400 InvalidMaintenanceWindowPropertyNull - Janela de manutenção inválida com as propriedades necessárias nulas. 400 InvalidMaintenanceWindowTypeWithPropertySpecified - O tipo de janela de manutenção não deve ter determinadas propriedades especificadas. 400 UpdateOfParameterNotSupported - Não há suporte para a atualização de '{0}'. 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 assinatura especificados. 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada. 404 SubscriptionDoesNotHaveVirtualCluster - O cluster virtual solicitado não foi encontrado 404 ResourceNotFound - O recurso solicitado não foi encontrado. 404 OperationIdNotFound - A operação com Id não existe. 409 VirtualClusterRemovalAlreadyInProgress – A remoção do cluster virtual já está em andamento. O cluster virtual é criado automaticamente com a criação da primeira instância e removido automaticamente com a exclusã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 excluído. 409 VirtualClusterIsBusy - O cluster virtual está ocupado no momento. Tente novamente a operação mais tarde. 409 VirtualClusterRemovalFailed - Falha na solicitação para remover o cluster virtual. Verifique se há recursos dependentes ativos. 409 ConflictingVirtualClusterOperation - Uma operação está atualmente em andamento para o cluster virtual. 409 OperationCancelled - A operação foi cancelada pelo usuário. 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 ConflictingSubscriptionOperation - Uma operação está em andamento para a assinatura. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas 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

Nome	Description
VirtualCluster	Um cluster virtual SQL do Azure.
VirtualClusterUpdate	Uma solicitação de atualização para um cluster virtual do Banco de Dados SQL do Azure.

VirtualCluster

Um cluster virtual SQL do Azure.

Nome	Tipo	Description
id	string	ID do recurso.
location	string	Local do recurso.
name	string	Nome do recurso.
properties.childResources	string[]	Lista de recursos neste cluster virtual.
properties.family	string	Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui.
properties.maintenanceConfigurationId	string	Especifica a ID de configuração de manutenção a ser aplicada a esse cluster virtual.
properties.subnetId	string	ID do recurso de sub-rede para o cluster virtual.
tags	object	Marcas de recurso.
type	string	Tipo de recurso.

VirtualClusterUpdate

Uma solicitação de atualização para um cluster virtual do Banco de Dados SQL do Azure.

Nome	Tipo	Description
properties.childResources	string[]	Lista de recursos neste cluster virtual.
properties.family	string	Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui.
properties.maintenanceConfigurationId	string	Especifica a ID de configuração de manutenção a ser aplicada a esse cluster virtual.
properties.subnetId	string	ID do recurso de sub-rede para o cluster virtual.
tags	object	Marcas de recurso.