Condividi tramite

Databases - Failover

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

Esegue il failover di un database.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
Con parametri facoltativi: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2023-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
 path True

string

Nome del database 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.
replicaType
 query

ReplicaType

Tipo di replica di cui eseguire il failover.

Risposte

Nome Tipo Descrizione
200 OK

Completata correttamente il failover del database.
202 Accepted

Il failover del database è in corso.

Intestazioni

Location: string
Other Status Codes

ErrorResponse

Risposte di errore:

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

  • 400 DatabaseFailoverThrottled: si è verificato un failover recente nel database o nel pool se il database appartiene a un pool elastico.

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

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

  • 409 DatabaseNotInStateToFailover: il database è attualmente in uno stato in modo che non sia 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 database

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200
Codice di stato:
202 
Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore
ReplicaType

Tipo di replica di cui eseguire il failover.

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.

ReplicaType

Enumerazione

Tipo di replica di cui eseguire il failover.

Valore Descrizione
Primary
ReadableSecondary