Databases - Failover

  • Referenz
Service:
SQL Database
API Version:
2020-11-01-preview

Failover für eine Datenbank.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2020-11-01-preview
With optional parameters: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2020-11-01-preview

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
 path True

string

Der Name der Datenbank, die ein Failover durchführen soll.
resourceGroupName
 path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName
 path True

string

Name des Servers
subscriptionId
 path True

string

Abonnement-ID für ein Azure-Abonnement.
api-version
 query True

string

API-Version, die für die Anforderung verwendet werden soll.
replicaType
 query

ReplicaType

Der Typ des Replikats, für das ein Failover ausgeführt werden soll.

Antworten

Name Typ Beschreibung
200 OK

Datenbankfailover erfolgreich abgeschlossen.
202 Accepted

Das Datenbankfailover wird ausgeführt.
Other Status Codes

Fehlerantworten: ***

  • 400 ManagementServiceFeatureDisabled: Der Benutzer hat versucht, ein feature zu verwenden, das deaktiviert ist.

  • 400 DatabaseFailoverThrottled: Es wurde kürzlich ein Failover für die Datenbank oder den Pool durchgeführt, wenn die Datenbank in einen Pool für elastische Datenbanken gehört.

  • 400 DatabaseFailoverNotSupportedOnSKU: Diese Art von kundeninitiiertem Failover wird für die angegebene SKU nicht unterstützt.

  • 409 ManagementServiceDatabaseBusy : Datenbank "{0}" ist mit einem anderen Vorgang beschäftigt. Versuchen Sie ihren Vorgang später.

  • 409 DatabaseNotInStateToFailover: Die Datenbank befindet sich derzeit in einem Zustand, sodass ein Failover nicht ausgestellt werden kann.

Beispiele

Failover an database

Sample Request

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=2020-11-01-preview

Sample Response

Status code:
200
Status code:
202

Definitionen

ReplicaType

Der Typ des Replikats, für das ein Failover ausgeführt werden soll.

Name Typ Beschreibung
Primary

string

ReadableSecondary

string