Databases - Failover

Service:

SQL Database

API Version:

2021-11-01

Failovers uitvoeren voor een database.

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

With optional parameters:

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-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database die moet worden uitgevoerd om een failover uit te voeren.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.
replicaType	query		ReplicaType	Het type replica waarvoor een failover moet worden uitgevoerd.

Antwoorden

Name	Type	Description
200 OK		De databasefailover is voltooid.
202 Accepted		Er wordt een databasefailover uitgevoerd.
Other Status Codes		Foutreacties: *** 400 ManagementServiceFeatureDisabled - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld. 400 DatabaseFailoverThrottled : er is een recente failover op de database of pool uitgevoerd als de database in een elastische pool hoort. 400 DatabaseFailoverNotSupportedOnSKU - Dit type door de klant geïnitieerde failover wordt niet ondersteund op de opgegeven SKU. 409 ManagementServiceDatabaseBusy - Database '{0}' is bezig met een andere bewerking. Probeer de bewerking later uit. 409 DatabaseNotInStateToFailover : de database heeft momenteel een zodanige status dat er geen failover kan worden uitgegeven.

Voorbeelden

Failover an database

Sample Request

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.core.util.Context;
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, 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

Sample Response

Status code:

200

Status code:

202

Definities

ReplicaType

Het type replica waarvoor een failover moet worden uitgevoerd.

Name	Type	Description
Primary	string
ReadableSecondary	string