Databases - Failover

Dienst:

SQL Database

API-Version:

2023-08-01

Failovert eine Datenbank.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank, die failovern soll.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName	path	True	string	Der Name des Servers.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.
replicaType	query		ReplicaType	Fehler beim Replikattyp.

Antworten

Name	Typ	Beschreibung
200 OK		Datenbankfailover erfolgreich abgeschlossen.
202 Accepted		Das Datenbankfailover wird ausgeführt. Header Location: string
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 DatabaseFailoverNotSupportedOnSKU – Dieser Typ von vom Kunden initiiertes Failover wird für die angegebene SKU nicht unterstützt. 400 DatabaseFailoverThrottled – Es gab ein kürzlich ausgeführtes Failover in der Datenbank oder im Pool, wenn die Datenbank zu einem elastischen Pool gehört. 400 ManagementServiceFeatureDisabled – Der Benutzer hat versucht, ein Feature zu verwenden, das deaktiviert ist. 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden. 409 DatabaseNotInStateToFailover – Die Datenbank befindet sich derzeit in einem Zustand, sodass kein Failover ausgegeben werden kann. 409 ManagementServiceDatabaseBusy - Datenbank '{0}' ist mit einem anderen Vorgang beschäftigt. Versuchen Sie es bitte später. 409 CannotCancelOperation – Der Verwaltungsvorgang befindet sich in einem Zustand, der nicht abgebrochen werden kann. 409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted – Der Vorgang für die Ressource konnte nicht abgeschlossen werden, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut. 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Failover an database

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

Statuscode:

202

Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ReplicaType	Fehler beim Replikattyp.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ReplicaType

Enumeration

Fehler beim Replikattyp.

Wert	Beschreibung
Primary
ReadableSecondary