Condividi tramite

Elastic Pools - Failover

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

Esegue il failover di un pool elastico.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}/failover?api-version=2023-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
elasticPoolName
 path True

string

Nome del pool elastico di cui eseguire il failover.
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.
serverName
 path True

string

Nome del server.
subscriptionId
 path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version
 query True

string

Versione dell'API da usare per la richiesta.

Risposte

Nome Tipo Descrizione
200 OK

Completato correttamente il failover del pool elastico.
202 Accepted

Il failover del pool elastico è in corso.

Intestazioni

Location: string
Other Status Codes

ErrorResponse

Risposte di errore:

  • 400 ElasticPoolFailoverNotSupportedOnSKU: questo tipo di failover avviato dal cliente non è supportato nello SKU specificato.

  • 400 ElasticPoolFailoverThrottled: si è verificato un failover recente nel pool elastico.

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

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

  • 409 ElasticPoolNotInStateToFailover: il pool elastico o un database all'interno del pool elastico è attualmente in uno stato in cui non è possibile eseguire il failover.

  • 409 ManagementServiceDatabaseBusy - Database '{0}' è occupato con un'altra operazione. Provare l'operazione in un secondo momento.

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

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

Esempio

Failover an elastic pool

Esempio di richiesta

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/testServer/elasticPools/testElasticPool/failover?api-version=2023-08-01

Risposta di esempio

Codice di stato:
200
Codice di stato:
202 
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2018-06-01

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Object

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

Object

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.