Databases - Failover

Service:

SQL Database

API Version:

2021-11-01

Bascule une base de données.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données à basculer.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.
replicaType	query		ReplicaType	Type de réplica à basculer.

Réponses

Nom	Type	Description
200 OK		Basculement de base de données terminé.
202 Accepted		Le basculement de base de données est en cours.
Other Status Codes		Réponses d’erreur : *** 400 ManagementServiceFeatureDisabled : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée. 400 DatabaseFailoverThrottled : il y a eu un basculement récent sur la base de données ou le pool si la base de données appartient à un pool élastique. 400 DatabaseFailoverNotSupportedOnSKU : ce type de basculement initié par le client n’est pas pris en charge sur la référence SKU donnée. 409 ManagementServiceDatabaseBusy : la base de données «{0} » est occupée par une autre opération. Essayez votre opération ultérieurement. 409 DatabaseNotInStateToFailover : la base de données est actuellement dans un état tel que le basculement ne peut pas être émis.

Exemples

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

Définitions

ReplicaType

Type de réplica à basculer.

Nom	Type	Description
Primary	string
ReadableSecondary	string