Databases - Failover

Référence

Service:: SQL Database

Version d'API:: 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

Avec des paramètres facultatifs:

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.

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

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


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

Exemple de réponse

Code d’état:: 200

Code d’état:: 202

Définitions

ReplicaType

Type de réplica à basculer.

Nom	Type	Description
Primary	string
ReadableSecondary	string

Partager via