Virtual Clusters - Update

Atualizações um aglomerado virtual.

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

Parâmetros do URI

Name In Required Type Description
resourceGroupName
path True
  • string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir do Azure Resource Manager API ou do portal.

subscriptionId
path True
  • string

O ID de subscrição que identifica uma subscrição do Azure.

virtualClusterName
path True
  • string

O nome do aglomerado virtual.

api-version
query True
  • string

A versão API a utilizar para o pedido.

Corpo do Pedido

Name Type Description
properties.family
  • string

Se o serviço tem diferentes gerações de hardware, para o mesmo SKU, então isso pode ser capturado aqui.

properties.maintenanceConfigurationId
  • string

Especifica o id de configuração de manutenção para aplicar a este cluster virtual.

tags
  • object

Etiquetas de recursos.

Respostas

Name Type Description
200 OK

Atualizou com sucesso o cluster virtual.

202 Accepted

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

Other Status Codes

Respostas de erro: ***

  • 400 SubscriçãoNotEnabledForFeature - Subscrição do utilizador não ativada para o utilizador de funcionalidades tentada a utilizar.

  • 400 ManagementServiceFeatureDabled - O utilizador tentou utilizar uma funcionalidade desativada.

  • 400 InvalidMaintenanceWindowSettings - Configurações inválidas da janela de manutenção.

  • 400 InvalidMaintenanceWindowProperty - Propriedade da janela de manutenção inválida foi especificada.

  • 400 InvalidMaintenanceWindowPropertyNull - Janela de manutenção inválida com propriedades necessárias nulas.

  • 400 InvalidMaintenanceWindowTypeWithPropertySpecified - O tipo de janela de manutenção não deve ter determinadas propriedades especificadas.

  • 400 UpdateOfParameterNotSupported - Update of '{0}' não é suportado.

  • 404 VirtualClusterDoesNotExist - O cluster virtual não existe.

  • 404 RecursosDoesNotExist - 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 especificado e na subscrição.

  • 404 SubscriçãoNotFound - A subscrição solicitada não foi encontrada.

  • 404 SubscriçãoDoesNotHaveVirtualCluster - O cluster virtual solicitado não foi encontrado

  • 404 ResourceNotFound - O recurso solicitado não foi encontrado.

  • 409 VirtualClusterRemovalAlreadyInProgress - Remoção do cluster virtual já está em andamento. O cluster virtual é automaticamente criado com criação de primeira instância, e removido automaticamente com a eliminação de ú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. Por favor, relemca a operação mais tarde.

  • 409 VirtualClusterRemovalFailed - Pedido de queda do cluster virtual falhou. Verifique se existem recursos dependentes ativos.

  • 409 ConflictingVirtualClusterOperation - Está em curso uma operação para o cluster virtual.

  • 429 SubscriçõesTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriçõesTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 ConflituosaSubscriçãoOperação - Está em curso uma operação para a subscrição.

  • 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

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 aglomerado virtual SQL do Azure.

VirtualClusterUpdate

Um pedido de atualização para um cluster virtual SQL do Azure Database.

VirtualCluster

Um aglomerado virtual SQL do Azure.

Name Type Description
id
  • string

Identificação de recursos.

location
  • string

Localização do recurso.

name
  • string

Nome de recurso.

properties.childResources
  • string[]

Lista de recursos neste cluster virtual.

properties.family
  • string

Se o serviço tem diferentes gerações de hardware, para o mesmo SKU, então isso pode ser capturado aqui.

properties.maintenanceConfigurationId
  • string

Especifica o id de configuração de manutenção para aplicar a este cluster virtual.

properties.subnetId
  • string

ID de recurso 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 SQL do Azure Database.

Name Type Description
properties.childResources
  • string[]

Lista de recursos neste cluster virtual.

properties.family
  • string

Se o serviço tem diferentes gerações de hardware, para o mesmo SKU, então isso pode ser capturado aqui.

properties.maintenanceConfigurationId
  • string

Especifica o id de configuração de manutenção para aplicar a este cluster virtual.

properties.subnetId
  • string

ID de recurso sub-rede para o cluster virtual.

tags
  • object

Etiquetas de recursos.