Virtual Clusters - Update

Aggiornamenti un cluster virtuale.

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

Parametri dell'URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

subscriptionId
path True
  • string

ID sottoscrizione che identifica una sottoscrizione di Azure.

virtualClusterName
path True
  • string

Nome del cluster virtuale.

api-version
query True
  • string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Name Type Description
properties.family
  • string

Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.

properties.maintenanceConfigurationId
  • string

Specifica l'ID di configurazione della manutenzione da applicare a questo cluster virtuale.

tags
  • object

Tag di risorse.

Risposte

Name Type Description
200 OK

È stato aggiornato correttamente il cluster virtuale.

202 Accepted

L'aggiornamento del cluster virtuale è in corso.

Other Status Codes

Risposte agli errori: **

  • 400 SubscriptionNotEnabledForFeature - Sottoscrizione utente non abilitata per l'utente di funzionalità che ha tentato di usare.

  • 400 ManagementServiceFeatureDisabled - Utente ha tentato di usare una funzionalità disabilitata.

  • 400 InvalidMaintenanceWindowSettings - Impostazioni della finestra di manutenzione non valide.

  • 400 InvalidMaintenanceWindowProperty - È stata specificata la proprietà della finestra di manutenzione non valida.

  • 400 InvalidMaintenanceWindowPropertyNull - Finestra di manutenzione non valida con proprietà necessarie Null.

  • 400 InvalidMaintenanceWindowTypeWithPropertySpecified - Tipo di finestra di manutenzione non deve avere determinate proprietà specificate.

  • 400 UpdateOfParameterNotSupported : l'aggiornamento di '{0}' non è supportato.

  • 404 VirtualClusterDoesNotExist - Il cluster virtuale non esiste.

  • 404 ResourceDoesNotExist - Risorsa con il nome '{0}' non esiste. Per continuare, specificare un nome di risorsa valido.

  • 404 VirtualClusterNotInSubscriptionResourceGroup - Il cluster virtuale specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 SubscriptionNotFound : la sottoscrizione richiesta non è stata trovata.

  • 404 SubscriptionDoesNotHaveVirtualCluster - Il cluster virtuale richiesto non è stato trovato

  • 404 ResourceNotFound : la risorsa richiesta non è stata trovata.

  • 409 VirtualClusterRemovalAlreadyInProgress - La rimozione del cluster virtuale è già in corso. Il cluster virtuale viene creato automaticamente con la creazione della prima istanza e automaticamente rimosso con l'eliminazione dell'ultima istanza. Altre informazioni sono disponibili qui: https://aka.ms/sqlmi-virtual-cluster-removal.

  • 409 VirtualClusterIsNotEmpty - Il cluster virtuale non è vuoto e non può essere eliminato.

  • 409 VirtualClusterIsBusy - Il cluster virtuale è attualmente occupato. Ripetere l'operazione in un secondo momento.

  • 409 VirtualClusterRemovalFailed - Richiesta di eliminazione del cluster virtuale non riuscita. Controllare se sono presenti risorse dipendenti attive.

  • 409 ConflittoVirtualClusterOperation: un'operazione è attualmente in corso per il cluster virtuale.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 ConflictingSubscriptionOperation : un'operazione è attualmente in corso per la sottoscrizione.

  • 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

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

Definizioni

VirtualCluster

Un cluster virtuale Azure SQL.

VirtualClusterUpdate

Richiesta di aggiornamento per un cluster virtuale del database di Azure SQL.

VirtualCluster

Un cluster virtuale Azure SQL.

Name Type Description
id
  • string

ID risorsa.

location
  • string

Percorso della risorsa.

name
  • string

Nome risorsa.

properties.childResources
  • string[]

Elenco delle risorse in questo cluster virtuale.

properties.family
  • string

Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.

properties.maintenanceConfigurationId
  • string

Specifica l'ID di configurazione della manutenzione da applicare a questo cluster virtuale.

properties.subnetId
  • string

ID risorsa subnet per il cluster virtuale.

tags
  • object

Tag di risorse.

type
  • string

Tipo di risorsa.

VirtualClusterUpdate

Richiesta di aggiornamento per un cluster virtuale del database di Azure SQL.

Name Type Description
properties.childResources
  • string[]

Elenco delle risorse in questo cluster virtuale.

properties.family
  • string

Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.

properties.maintenanceConfigurationId
  • string

Specifica l'ID di configurazione della manutenzione da applicare a questo cluster virtuale.

properties.subnetId
  • string

ID risorsa subnet per il cluster virtuale.

tags
  • object

Tag di risorse.