Partager via

Databases - Failover

  • Référence
Service:
SQL Database
Version d'API:
2023-08-01

Basculement d’une base de données.

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

Nom du serveur.
subscriptionId
 path True

string

ID d’abonnement qui identifie 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é avec succès.
202 Accepted

Le basculement de base de données est en cours.

En-têtes

Location: string
Other Status Codes

ErrorResponse

Réponses d’erreur : ***

  • 400 DatabaseFailoverNotSupportedOnSKU : ce type de basculement initié par le client n’est pas pris en charge sur la référence SKU donnée.

  • 400 DatabaseFailoverThrottled : basculement récent sur la base de données ou le pool si la base de données appartient à un pool élastique.

  • 400 ManagementServiceFeatureDisabled : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée.

  • 404 OperationIdNotFound : l’opération avec ID n’existe pas.

  • 409 DatabaseNotInStateToFailover : la base de données est actuellement dans un état tel que le basculement ne peut pas être émis.

  • 409 ManagementServiceDatabaseBusy - Database '{0}' est occupé avec une autre opération. Essayez votre opération ultérieurement.

  • 409 CannotCancelOperation : l’opération de gestion est dans un état qui ne peut pas être annulé.

  • 409 OperationCancelled : l’opération a été annulée par l’utilisateur.

  • 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération.

  • 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

Exemples

Failover an database

Exemple de requête

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

Exemple de réponse

Code d’état:
200
Code d’état:
202 
Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

Définitions

Nom Description
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
ReplicaType

Type de réplica à basculer.

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.
type

string

Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d’erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ReplicaType

Énumération

Type de réplica à basculer.

Valeur Description
Primary
ReadableSecondary