Virtual Clusters - Update

Atualizações um cluster virtual.

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

Parâmetros de URI

Name In Required Type 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

Name Type Description
properties.family
  • string

Se o serviço tiver diferentes gerações 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

Name Type Description
200 OK

Atualizou com êxito o cluster virtual.

202 Accepted

A atualização do cluster virtual está em andamento.

Other Status Codes

Respostas de erro: ***

  • 400 SubscriptionNotEnabledForFeature – Assinatura do 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 de janela de manutenção inválidas.

  • 400 InvalidMaintenanceWindowProperty - 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.

  • 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á em andamento no momento para o cluster virtual.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas pelos recursos disponíveis.

  • 429 ConflictingSubscriptionOperation - Uma operação está em andamento para a assinatura.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas pelos recursos disponíveis.

Exemplos

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

Definições

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.

Name Type 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 diferentes gerações 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.

Name Type Description
properties.childResources
  • string[]

Lista de recursos neste cluster virtual.

properties.family
  • string

Se o serviço tiver diferentes gerações 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.