Condividi tramite

Virtual Clusters - Update

Servizio:
SQL Database
Versione API:
2023-08-01

Aggiorna un cluster virtuale esistente.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
 path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager 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

Nome Tipo Descrizione
properties.version

string

Versione del cluster virtuale.
tags

object

Tag di risorsa.

Risposte

Nome Tipo Descrizione
200 OK

VirtualCluster

Cluster virtuale aggiornato correttamente.
202 Accepted

L'aggiornamento del cluster virtuale è in corso.

Intestazioni

Location: string
Other Status Codes

ErrorResponse

Risposte di errore:

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

  • 400 RequestCantLandOnPaaSv2Platform: la richiesta deve essere impostata sulla piattaforma PaaSv2, ma PaaSv2 non è abilitata.

  • 400 CustomMaintenanceWindowIsDisabled - Finestra di manutenzione personalizzata non abilitata.

  • 400 DeleteOfVersion2VirtualClusterIsDisabled : l'eliminazione del cluster virtuale con la versione 2 non è abilitata.

  • 400 DeleteOfVirtualClusterIsDisabled: l'eliminazione del cluster virtuale non è abilitata.

  • 400 DnsRefreshOnVirtualClusterIsDisabled - L'aggiornamento dei record DNS nel cluster virtuale non è abilitato.

  • 400 ManagementServiceFeatureDisabled - L'utente ha tentato di usare una funzionalità disabilitata.

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

  • 404 OperationIdNotFound - L'operazione con ID non esiste.

  • 409 VirtualClusterRemovalAlreadyInProgress - La rimozione del cluster virtuale è già in corso. Il cluster virtuale viene creato automaticamente con la creazione della prima istanza e rimosso automaticamente 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 ConflictingVirtualClusterOperation: un'operazione è attualmente in corso per il cluster virtuale.

  • 409 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato.

  • 409 OperationCancelled - L'operazione è stata annullata dall'utente.

  • 409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

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

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione.

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

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

Esempio

Update virtual cluster with tags

Esempio di richiesta

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=2023-08-01

{
  "tags": {
    "tkey": "tvalue1"
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "properties": {},
  "tags": {
    "tkey": "tvalue3"
  },
  "location": "japaneast",
  "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"
}
Codice di stato:
202 
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/virtualclusterazureasyncoperation/00000000-1111-2222-3333-444444444444?api-version=2022-11-01-preview

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore
VirtualCluster

Un cluster virtuale SQL di Azure.
VirtualClusterUpdate

Richiesta di aggiornamento per il cluster virtuale.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

ErrorDetail[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

VirtualCluster

Oggetto

Un cluster virtuale SQL di Azure.

Nome Tipo Descrizione
id

string

ID risorsa.
location

string

Percorso della risorsa.
name

string

Nome risorsa.
properties.childResources

string[]

Elenco di risorse in questo cluster virtuale.
properties.subnetId

string

ID risorsa subnet per il cluster virtuale.
properties.version

string

Versione del cluster virtuale.
tags

object

Tag di risorsa.
type

string

Tipo di risorsa.

VirtualClusterUpdate

Oggetto

Richiesta di aggiornamento per il cluster virtuale.

Nome Tipo Descrizione
properties.childResources

string[]

Elenco di risorse in questo cluster virtuale.
properties.subnetId

string

ID risorsa subnet per il cluster virtuale.
properties.version

string

Versione del cluster virtuale.
tags

object

Tag di risorsa.