Condividi tramite


Databases - Failover

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=2021-11-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2021-11-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
path True

string

Nome del database da eseguire in failover.

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.

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 da eseguire con failover.

Risposte

Nome Tipo Descrizione
200 OK

Failover del database completato correttamente.

202 Accepted

Il failover del database è in corso.

Other Status Codes

Risposte agli errori: **

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

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

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

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

  • 409 DatabaseNotInStateToFailover: il database è attualmente in uno stato in cui non è possibile eseguire il failover.

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=2021-11-01

Risposta di esempio

Definizioni

ReplicaType

Tipo di replica da eseguire con failover.

Nome Tipo Descrizione
Primary

string

ReadableSecondary

string