Databases - Failover

Dienst:

SQL Database

API-Version:

2021-11-01

Failover für eine Datenbank.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank, die ein Failover ausgeführt werden 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		Das Datenbankfailover wurde erfolgreich abgeschlossen.
202 Accepted		Ein 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: Dieser Typ des vom Kunden initiierten Failovers wird für die angegebene SKU nicht unterstützt. 409 ManagementServiceDatabaseBusy : Datenbank "{0}" ist mit einem anderen Vorgang beschäftigt. Versuchen Sie es später mit dem Vorgang. 409 DatabaseNotInStateToFailover: Die Datenbank befindet sich derzeit in einem Zustand, sodass kein Failover ausgegeben werden kann.

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

Java

import com.azure.resourcemanager.sql.models.ReplicaType;

/**
 * Samples for Databases Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverDatabase.json
     */
    /**
     * Sample code: Failover an database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void failoverAnDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().failover("group1", "testServer", "testDatabase",
            ReplicaType.PRIMARY, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:

200

Statuscode:

202

Definitionen

ReplicaType

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

Name	Typ	Beschreibung
Primary	string
ReadableSecondary	string