CreateDiskReplicaPair - - Centre de documentation Alibaba Cloud

Notes d'utilisation

La réplication asynchrone est une fonctionnalité qui protège les données entre différentes régions en utilisant les capacités de réplication d'Elastic Block Storage (EBS). Cette fonctionnalité permet de répliquer de manière asynchrone les données d'un disque situé dans une région vers un disque situé dans une autre région, à des fins de reprise après sinistre. Vous pouvez utiliser cette fonctionnalité pour mettre en œuvre une stratégie de reprise après sinistre pour vos activités critiques, afin de protéger les données de vos bases de données et d'améliorer la continuité de service. L'utilisation de la fonction de réplication asynchrone entraîne la facturation de la bande passante selon un mode d'abonnement.

Actuellement, la fonction de réplication asynchrone ne peut répliquer les données qu'entre des disques ESSD (Enhanced SSD). Les fonctionnalités des disques inclus dans des paires de réplication sont limitées.

Tenez compte des points suivants :

Assurez-vous que le disque source (disque principal), à partir duquel les données doivent être répliquées, et le disque de destination (disque secondaire), vers lequel les données doivent être répliquées, ont été créés. Appelez l'opération CreateDisk pour créer des disques.
Le disque secondaire ne peut pas se trouver dans la même région que le disque principal. Pour obtenir la liste des régions prenant en charge la réplication asynchrone, consultez la rubrique Présentation.
Après avoir appelé cette opération pour créer une paire de réplication, appelez l'opération StartDiskReplicaPair pour activer la réplication asynchrone et permettre la réplication périodique des données du disque principal vers le disque secondaire entre les régions.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateDiskReplicaPair	L'opération à effectuer. Définissez la valeur sur CreateDiskReplicaPair.
RegionId	String	Oui	cn-shanghai	L'ID de la région dans laquelle créer la paire de réplication.
SourceZoneId	String	Oui	cn-beijing-f	L'ID de la zone du disque principal.
DiskId	String	Oui	d-iq80sgp4d0xbk24q****	L'ID du disque principal.
DestinationRegionId	String	Oui	cn-shanghai	L'ID de la région du disque secondaire. Appelez l'opération DescribeRegions pour interroger la liste la plus récente des régions prenant en charge la réplication asynchrone.
DestinationDiskId	String	Oui	d-sa1f82p58p1tdw9g****	L'ID du disque secondaire.
DestinationZoneId	String	Oui	cn-shanghai-e	L'ID de la zone du disque secondaire.
PairName	String	Non	TestReplicaPair	Le nom de la paire de réplication. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_), des points (.) et des traits d'union (-).
Description	String	Non	This is description.	La description de la paire de réplication. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par `http://` ou `https://`.
ChargeType	String	Non	PREPAY	La méthode de facturation de la paire de réplication. Valeurs possibles : PREPAY : abonnement POSTPAY : paiement à l'utilisation Valeur par défaut : POSTPAY.
Period	Long	Non	1	La durée de l'abonnement pour la paire de réplication. Lorsque le paramètre `ChargeType` est défini sur PREPAY, ce paramètre est obligatoire. Valeurs possibles : 1, 2, 3, 6, 12, 24, 36 et 60. L'unité de durée de l'abonnement est spécifiée par le paramètre `PeriodUnit`.
PeriodUnit	String	Non	Month	L'unité de durée de l'abonnement pour la paire de réplication. Définissez la valeur sur Month. Valeur possible : Month
ClientToken	String	Non	123e4567-e89b-12d3-a456-42665544****	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique parmi les différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez la rubrique Comment garantir l'idempotence.
Bandwidth	Long	Non	10240	La bande passante utilisée pour répliquer de manière asynchrone les données du disque principal vers le disque secondaire. Unité : Kbit/s. Valeurs possibles : 10240 20480 51200 102400 Valeur par défaut : 10240. Lorsque vous définissez le paramètre ChargeType sur POSTPAY, le paramètre Bandwidth est automatiquement défini sur 0 et ne peut pas être modifié. La valeur 0 indique que la bande passante est allouée dynamiquement en fonction du volume de données répliqué de manière asynchrone du disque principal vers le disque secondaire.
RPO	Long	Non	900	L'objectif de point de récupération (RPO) de la paire de réplication. Unité : secondes. Valeur possible : 900.
ResourceGroupId	String	Non	rg-acfmvs****	L'ID du groupe de ressources auquel attribuer la paire de réplication.
Tag.N.Key	String	Non	TestKey	La clé du tag N à ajouter à la paire de réplication.
Tag.N.Value	String	Non	TestValue	La valeur du tag N à ajouter à la paire de réplication.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	C123F94F-4E38-19AE-942A-A8D6F44F****	L'ID de la requête.
ReplicaPairId	String	pair-cn-dsa****	L'ID de la paire de réplication.
OrderId	String	123456****	L'ID de la commande.

Exemples

Exemples de requêtes

http(s)://ebs.cn-beijing.aliyuncs.com/?Action=CreateDiskReplicaPair
&RegionId=cn-shanghai
&SourceZoneId=cn-beijing-f
&DiskId=d-iq80sgp4d0xbk24q****
&DestinationRegionId=cn-shanghai
&DestinationDiskId=d-sa1f82p58p1tdw9g****
&DestinationZoneId=cn-shanghai-e
&PairName=TestReplicaPair
&Description=This is description.
&ChargeType=PREPAY
&Period=1
&PeriodUnit=Month
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Bandwidth=10240
&RPO=900
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDiskReplicaPairResponse>
    <RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
    <ReplicaPairId>pair-cn-dsa****</ReplicaPairId>
    <OrderId>123456****</OrderId>
</CreateDiskReplicaPairResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F****",
  "ReplicaPairId" : "pair-cn-dsa****",
  "OrderId" : "123456****"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	La requête et une requête précédente contiennent le même jeton client mais des paramètres différents.
403	OperationDenied	The operation is not allowed.	Vous ne pouvez pas effectuer cette opération.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	Cette opération ne peut pas être effectuée sur la ressource dans son état actuel.
403	OperationDenied.QuotaExceed	The operation is not allowed due to quota exceed.	Le quota est dépassé.
403	LastTokenProcessing	The last token request is processing.	La valeur de clientToken est utilisée dans une autre requête en cours de traitement. Réessayez ultérieurement.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Votre compte ne dispose pas d'un solde suffisant.
403	Forbidden	User is not authorized to operate.	Vous ne disposez pas des autorisations nécessaires pour effectuer cette opération sur la ressource. Vérifiez les autorisations de votre compte ou contactez l'administrateur du compte locataire Apsara Stack.
403	Forbidden.Action	User is not authorized to operate this action.	Vous n'avez pas accès à cette opération. Vérifiez les autorisations de votre compte ou contactez l'administrateur du compte Alibaba Cloud.
404	NoSuchResource	The specified resource does not exist.	La ressource spécifiée est introuvable.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur interne s'est produite.
504	RequestTimeout	The request is timeout, please try again later.	La requête a expiré. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.