Virtual Clusters - Get

Servizio:

SQL Database

Versione API:

2023-08-01

Ottiene un cluster virtuale.

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

Risposte

Nome	Tipo	Descrizione
200 OK	VirtualCluster	È stato recuperato correttamente il cluster virtuale specificato.
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 SubscriptionNotFound - La sottoscrizione richiesta non è stata trovata. 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 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. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 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. 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

Gets a virtual cluster

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-f769ed71-b3ad-491a-a9d5-26eeceaa6be2?api-version=2023-08-01

Risposta di esempio

Codice di stato:

200

{
  "properties": {
    "subnetId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/cltest",
    "version": "2.0",
    "childResources": [
      "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl",
      "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/mi"
    ]
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "name": "vc-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "type": "Microsoft.Sql/virtualClusters"
}

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.

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.