Replication Links - Failover

Référence

Service:: SQL Database

API Version:: 2021-11-01

Bascule du serveur principal actuel vers ce serveur.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données.
linkId	path	True	string	Nom du lien de réplication.
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.

Réponses

Nom	Type	Description
200 OK	ReplicationLink	Basculement réussi.
202 Accepted		L’opération de basculement est en cours.
Other Status Codes		Réponses d’erreur : *** 400 ReplicationLinksReplicationLinkNameIsInvalid : le nom du lien de réplication doit être un guid valide. 400 GeoReplicationDatabaseNotSecondary : l’opération s’attend à ce que la base de données soit une cible de réplication. 400 LedgerNoDropLink : la géoréplication ne peut pas être arrêtée, car les chargements de digestes de la base de données sont activés. Désactivez les téléchargements de digest du registre et réessayez l’opération. 400 CannotUseTrailingWhitespacesInDatabaseName : la validation du nom de la base de données a échoué. 400 GeoReplicationDatabaseNotSecondary : l’opération s’attend à ce que la base de données soit une cible de réplication. 400 CannotUseReservedDatabaseName : impossible d’utiliser le nom de la base de données réservée dans cette opération. 400 InvalidServerName : nom de serveur non valide spécifié. 400 PlannedFailoverTimedOut : l’utilisateur a appelé basculement planifié et il a expiré lors de la tentative de contact avec le service de gestion des partenaires. 400 InvalidIdentifier : l’identificateur contient NULL ou un caractère Unicode non valide. 400 IncorrectReplicationLinkState : l’opération s’attend à ce que la base de données soit dans un état attendu sur le lien de réplication. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 404 ResourceNotFound : la ressource demandée est introuvable. 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 404 DatabaseDoesNotExist : l’utilisateur a spécifié un nom de base de données qui n’existe pas sur ce serveur instance. 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. 409 InvalidOperationForDatabaseNotInReplicationRelationship : une opération d’amorçage de réplication a été effectuée sur une base de données qui se trouve déjà dans une relation de réplication. 409 GeoReplicationCannotBecomePrimaryDuringUndo : l’utilisateur a tenté de basculer ou de forcer l’arrêt d’un lien géographique alors que le secondaire est dans un état où il n’est peut-être pas physiquement cohérent et ne peut donc pas entrer le rôle principal. 409 DuplicateGeoDrRelation : les bases de données sont déjà dans une relation de réplication. Il s’agit d’une demande en double. 409 UpdateSloInProgress : l’utilisateur a tenté de lancer une opération incompatible alors qu’une mise à jour SLO était en cours. 409 ManagementServiceDatabaseBusy - La base de données '{0}' est occupée par une autre opération. Essayez votre opération ultérieurement. 409 ConflictingSystemOperationInProgress : une opération de maintenance du système est en cours sur la base de données et d’autres opérations doivent attendre qu’elle soit terminée. 409 FailoverGroupAlreadySetup : l’opération ne peut pas être effectuée, car le lien de géoréplication fait partie d’un groupe de basculement. Vous devez supprimer la base de données du groupe afin d’arrêter ou de basculer individuellement. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes 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à du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Nom

Type

Description

200 OK

ReplicationLink

Basculement réussi.

202 Accepted

L’opération de basculement est en cours.

Other Status Codes

Réponses d’erreur : ***

400 ReplicationLinksReplicationLinkNameIsInvalid : le nom du lien de réplication doit être un guid valide.
400 GeoReplicationDatabaseNotSecondary : l’opération s’attend à ce que la base de données soit une cible de réplication.
400 LedgerNoDropLink : la géoréplication ne peut pas être arrêtée, car les chargements de digestes de la base de données sont activés. Désactivez les téléchargements de digest du registre et réessayez l’opération.
400 CannotUseTrailingWhitespacesInDatabaseName : la validation du nom de la base de données a échoué.
400 GeoReplicationDatabaseNotSecondary : l’opération s’attend à ce que la base de données soit une cible de réplication.
400 CannotUseReservedDatabaseName : impossible d’utiliser le nom de la base de données réservée dans cette opération.
400 InvalidServerName : nom de serveur non valide spécifié.
400 PlannedFailoverTimedOut : l’utilisateur a appelé basculement planifié et il a expiré lors de la tentative de contact avec le service de gestion des partenaires.
400 InvalidIdentifier : l’identificateur contient NULL ou un caractère Unicode non valide.
400 IncorrectReplicationLinkState : l’opération s’attend à ce que la base de données soit dans un état attendu sur le lien de réplication.
404 OperationIdNotFound : l’opération avec ID n’existe pas.
404 ResourceNotFound : la ressource demandée est introuvable.
404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable
404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.
404 OperationIdNotFound : l’opération avec ID n’existe pas.
404 DatabaseDoesNotExist : l’utilisateur a spécifié un nom de base de données qui n’existe pas sur ce serveur instance.
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.
409 InvalidOperationForDatabaseNotInReplicationRelationship : une opération d’amorçage de réplication a été effectuée sur une base de données qui se trouve déjà dans une relation de réplication.
409 GeoReplicationCannotBecomePrimaryDuringUndo : l’utilisateur a tenté de basculer ou de forcer l’arrêt d’un lien géographique alors que le secondaire est dans un état où il n’est peut-être pas physiquement cohérent et ne peut donc pas entrer le rôle principal.
409 DuplicateGeoDrRelation : les bases de données sont déjà dans une relation de réplication. Il s’agit d’une demande en double.
409 UpdateSloInProgress : l’utilisateur a tenté de lancer une opération incompatible alors qu’une mise à jour SLO était en cours.
409 ManagementServiceDatabaseBusy - La base de données '{0}' est occupée par une autre opération. Essayez votre opération ultérieurement.
409 ConflictingSystemOperationInProgress : une opération de maintenance du système est en cours sur la base de données et d’autres opérations doivent attendre qu’elle soit terminée.
409 FailoverGroupAlreadySetup : l’opération ne peut pas être effectuée, car le lien de géoréplication fait partie d’un groupe de basculement. Vous devez supprimer la base de données du groupe afin d’arrêter ou de basculer individuellement.
429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.
429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes 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à du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Exemples

Planned failover of a replication link

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb/failover?api-version=2021-11-01


import com.azure.core.util.Context;

/** Samples for ReplicationLinks Failover. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkFailover.json
     */
    /**
     * Sample code: Planned failover of a replication link.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void plannedFailoverOfAReplicationLink(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().failover("Default", "sourcesvr", "gamma-db",
            "4891ca10-ebd0-47d7-9182-c722651780fb", 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

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerLocation": "Japan East",
    "role": "Primary",
    "partnerRole": "Secondary",
    "replicationMode": "ASYNC",
    "startTime": "2018-06-21T08:12:43.783Z",
    "percentComplete": 100,
    "replicationState": "CATCH_UP",
    "isTerminationAllowed": true,
    "linkType": "GEO"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "4891ca10-ebd0-47d7-9182-c722651780fb"
}

Status code:: 202

Définitions

Nom	Description
ReplicationLink	Lien de réplication.
ReplicationLinkType	Type de lien (GEO, NOMMÉ, VEILLE).
ReplicationRole	Rôle de réplication local.
ReplicationState	État de réplication (PENDING, SEEDING, CATCHUP, SUSPENDED).

ReplicationLink

Lien de réplication.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.isTerminationAllowed	boolean	Indique si l’utilisateur est actuellement autorisé à mettre fin au lien.
properties.linkType	ReplicationLinkType	Type de lien (GEO, NOMMÉ, VEILLE).
properties.partnerDatabase	string	Base de données partenaire de ressources.
properties.partnerLocation	string	Emplacement du partenaire de ressources.
properties.partnerRole	ReplicationRole	Rôle de réplication partenaire.
properties.partnerServer	string	Serveur partenaire de ressources.
properties.percentComplete	integer	Pourcentage d’achèvement d’amorçage pour le lien.
properties.replicationMode	string	Mode de réplication.
properties.replicationState	ReplicationState	État de réplication (PENDING, SEEDING, CATCHUP, SUSPENDED).
properties.role	ReplicationRole	Rôle de réplication local.
properties.startTime	string	Heure à laquelle le lien a été créé.
type	string	Type de ressource.

ReplicationLinkType

Type de lien (GEO, NOMMÉ, VEILLE).

Nom	Type	Description
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

Rôle de réplication local.

Nom	Type	Description
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

État de réplication (PENDING, SEEDING, CATCHUP, SUSPENDED).

Nom	Type	Description
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string

Replication Links - Failover

Paramètres URI

Réponses

Exemples

Planned failover of a replication link

Sample Request

Sample Response

Définitions

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState

Ressources supplémentaires