Replication Links - Create Or Update

Service:

SQL Database

API Version:

2023-08-01-preview

Mises à jour le type de lien de réplication.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}?api-version=2023-08-01-preview

Paramètres URI

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

Corps de la demande

Nom	Type	Description
properties.linkType	ReplicationLinkType	Type de lien (GEO, NOMMÉ, VEILLE). L’opération de mise à jour ne prend pas en charge NAMED.

Réponses

Nom	Type	Description
200 OK	ReplicationLink	Mise à jour réussie du lien de réplication.
202 Accepted		L’opération de mise à jour est en cours.
Other Status Codes	ErrorResponse	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 ReplicationLinksReplicationLinkTypeIsInvalid : le LinkType n’est pas valide. Les valeurs valides sont STANDBY et GEO. 400 ReplicationLinksCreateIsNotSupported : la création d’un lien de réplication n’est pas prise en charge. 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 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave : la configuration de la géoréplication n’est pas prise en charge pour les bases de données utilisant des valeurs différentes de la propriété preferredEnclaveType. La base de données «{0} » principale sur le serveur «{1} » utilise le «{2} » preferredEnclaveType, tandis que le preferredEnclaveType spécifié pour la base de données «{3} » secondaire sur le serveur «{4} » est « ».{5} 400 VBSEnclaveNotSupportedFor PlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes : le basculement planifié entre une base de données primaire et une base de données secondaire avec des bases de données preferredEnclaveType différentes n’est pas pris en charge pour les enclaves de sécurité basées sur la virtualisation (VBS). 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 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 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. 409 InvalidOperationForDatabaseNotInReplicationRelationship : une opération de réplication a été effectuée sur une base de données qui n’est pas 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

Updates Replication Link

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/00000000-1111-2222-3333-666666666666?api-version=2023-08-01-preview

{
  "properties": {
    "linkType": "STANDBY"
  }
}

Sample Response

Status code:

200

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/testsvr/databases/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": "STANDBY"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "00000000-1111-2222-3333-666666666666"
}

Status code:

202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/replicationLinksOperationResults/11111111-1111-1111-1111-111111111111

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
ReplicationLink	Lien de réplication.
ReplicationLinkType	Type de lien (GEO, NOMMÉ, VEILLE). L’opération de mise à jour ne prend pas en charge NAMED.
ReplicationRole	Rôle de réplication local.
ReplicationState	État de réplication (PENDING, SEEDING, CATCHUP, SUSPENDED).

ErrorAdditionalInfo

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

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

ErrorDetail

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

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

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). L’opération de mise à jour ne prend pas en charge NAMED.
properties.partnerDatabase	string	Base de données partenaire de ressources.
properties.partnerDatabaseId	string	ID de 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). L’opération de mise à jour ne prend pas en charge NAMED.

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