DescribeDiskReplicaPairs - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Pour connaître la liste des régions prenant en charge la réplication asynchrone, consultez la rubrique Présentation.
Lorsque vous appelez cette opération pour une région donnée, la réponse inclut les informations de la paire de réplication si le disque primaire (source) ou le disque secondaire (destination) se trouve dans cette région.
Pour paginer les résultats, configurez les paramètres NextToken et MaxResults. Lors du premier appel, définissez MaxResults pour limiter le nombre maximal d'entrées renvoyées. La valeur renvoyée pour NextToken sert de jeton de pagination pour l'appel suivant. Pour les appels suivants, attribuez à NextToken la valeur obtenue précédemment et définissez MaxResults pour spécifier le nombre maximal d'entrées à renvoyer.

Débogage

OpenAPI Explorer calcule automatiquement la signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération, car il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeDiskReplicaPairs	Nom de l'opération à effectuer. Définissez la valeur sur DescribeDiskReplicaPairs.
RegionId	String	Yes	cn-beijing	ID de la région du disque primaire ou secondaire de la paire de réplication. Appelez l'opération DescribeRegions pour obtenir la liste actualisée des régions prenant en charge la réplication asynchrone.
MaxResults	Long	No	1	Nombre maximal d'entrées à renvoyer. Utilisez ce paramètre conjointement avec NextToken. Valeurs valides : 1 à 500. Valeur par défaut : 10.
NextToken	String	No	AAAAAdDWBF2****	Jeton de pagination utilisé dans la requête suivante pour récupérer la page de résultats suivante. Ne spécifiez pas ce paramètre lors de la première requête. Pour les requêtes suivantes, indiquez le jeton obtenu lors de la requête précédente. Lorsque vous spécifiez NextToken, les paramètres de requête PageSize et PageNumber sont ignorés et le paramètre de réponse TotalCount n'est pas valide.
PairIds	String	No	pair-cn-dsa****	ID des paires de réplication. Vous pouvez spécifier un ou plusieurs ID, séparés par des virgules (,). Exemple : `pair-cn-dsa,pair-cn-asd`. Par défaut, ce paramètre est vide, ce qui signifie que toutes les paires de réplication de la région spécifiée sont interrogées. Vous pouvez saisir jusqu'à 100 ID de paires de réplication.
Site	String	No	production	Type de site à partir duquel les informations des paires de réplication sont récupérées. Valeurs valides : production : site primaire backup : site secondaire Valeur par défaut : production.
ReplicaGroupId	String	No	pg-****	ID du groupe cohérent de paires de réplication. Spécifiez l'ID d'un groupe pour interroger les paires de réplication qui lui sont associées. Exemple : `pg-**`. Par défaut, ce paramètre est vide, ce qui signifie que toutes les paires de réplication de la région spécifiée sont interrogées. Remarque** Si vous définissez ce paramètre sur `-`, seules les paires de réplication non associées à un groupe cohérent sont interrogées.
PageNumber	Integer	No	5	Numéro de page.
PageSize	Integer	No	10	Nombre d'entrées par page. Valeurs valides : 1 à 100.
ResourceGroupId	String	No	rg-acfmvs******	ID du groupe de ressources auquel la paire de réplication est attribuée.
Tag.N.Key	String	No	TestKey	Clé du tag N de la paire de réplication.
Tag.N.Value	String	No	TestValue	Valeur du tag N de la paire de réplication.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****	ID de la requête.
NextToken	String	AAAAAdDWBF2****	Jeton de pagination utilisé dans la requête suivante pour récupérer la page de résultats suivante. Si NextToken est vide, il n'y a pas de page suivante.
ReplicaPairs	Array of ReplicaPair		Détails des paires de réplication.
ReplicaPairId	String	pair-cn-dsa****	ID de la paire de réplication.
SourceRegion	String	cn-beijing	ID de la région du disque primaire.
SourceZoneId	String	cn-beijing-a	ID de la zone du disque primaire.
SourceDiskId	String	d-bp131n0q38u3a4zi****	ID du disque primaire.
DestinationRegion	String	cn-shanghai	ID de la région du disque secondaire.
DestinationZoneId	String	cn-shanghai-b	ID de la zone du disque secondaire.
DestinationDiskId	String	d-asdfjl2342kj2l3k4****	ID du disque secondaire.
PairName	String	TestReplicaPair	Nom de la paire de réplication.
Description	String	This is description.	Description de la paire de réplication.
Status	String	created	État de la paire de réplication. Valeurs valides : invalid : la paire de réplication n'est pas valide. Une paire de réplication passe à cet état lorsqu'elle devient anormale. creating : la paire de réplication était en cours de création. created : la paire de réplication a été créée. create_failed : la création de la paire de réplication a échoué. initial_syncing : les données ont été synchronisées du disque primaire vers le disque secondaire pour la première fois. Après la création et l'activation d'une paire de réplication, celle-ci se trouve dans cet état lors de la première synchronisation des données du disque primaire vers le disque secondaire. manual_syncing : les données étaient en cours de synchronisation manuelle du disque primaire vers le disque secondaire. Après une synchronisation manuelle, la paire de réplication revient à l'état Stopped. Lors de la première synchronisation manuelle, la paire de réplication se trouve dans l'état manual_syncing pendant l'opération. syncing : les données étaient en cours de synchronisation du disque primaire vers le disque secondaire. Une paire de réplication se trouve dans cet état lorsque la réplication asynchrone des données du disque primaire vers le disque secondaire est en cours (hors première synchronisation). normal : la paire de réplication fonctionnait comme prévu. Une paire de réplication passe à cet état lorsque le système termine la réplication des données du disque primaire vers le disque secondaire au sein du cycle de réplication actuel. stopping : la paire de réplication était en cours d'arrêt. stopped : la paire de réplication a été arrêtée. stop_failed : l'arrêt de la paire de réplication a échoué. failovering : un basculement était en cours. failovered : un basculement a été effectué. failover_failed : le basculement a échoué. reprotecting : une réplication inverse était en cours. reprotect_failed : la réplication inverse a échoué. deleting : la paire de réplication était en cours de suppression. delete_failed : la suppression de la paire de réplication a échoué. deleted : la paire de réplication a été supprimée.
RPO	Long	900	Objectif de point de récupération (RPO) de la paire de réplication. Unité : secondes. 86 400 secondes équivalent à 24 heures.
Bandwidth	Long	10240	Bande passante utilisée pour la réplication asynchrone des données du disque primaire vers le disque secondaire. Unité : Kbit/s.
StatusMessage	String	PrePayOrderExpired	Message décrivant l'état de la paire de réplication. Ce paramètre contient une valeur lorsque `Status` est défini sur invalid ou `create_failed`. Valeurs valides : PrePayOrderExpired : la paire de réplication a expiré. PostPayOrderCeaseService : la paire de réplication en paiement à l'utilisation a été suspendue en raison d'un impayé. DeviceRemoved : le disque primaire ou secondaire a été supprimé. DeviceKeyChanged : le mappage `DeviceKey` du disque primaire ou secondaire a changé. DeviceSizeChanged : la valeur `DeviceSize` du disque primaire ou secondaire a changé. OperationDenied.QuotaExceed : le nombre maximal de paires de réplication pouvant être créées a été atteint.
LastRecoverPoint	Long	1649751977	Horodatage de la dernière réplication des données du disque primaire vers le disque secondaire au sein de la paire de réplication. Unité : secondes. 86 400 secondes équivalent à 24 heures.
ReplicaGroupId	String	pg-xxxx****	ID du groupe cohérent de paires de réplication auquel la paire de réplication appartient.
CreateTime	Long	1649750977	Horodatage de la création de la paire de réplication. Unité : secondes. 86 400 secondes équivalent à 24 heures.
ReplicaGroupName	String	pg-name****	Nom du groupe cohérent de paires de réplication auquel la paire de réplication appartient.
Site	String	production	Type de site à partir duquel les informations sur les paires de réplication et le groupe cohérent de paires de réplication ont été obtenues. Valeurs valides : production : site primaire backup : site secondaire
PrimaryRegion	String	cn-beijing	Région source initiale (région primaire) de la paire de réplication.
StandbyRegion	String	cn-shanghai	Région de destination initiale (région secondaire) de la paire de réplication.
PrimaryZone	String	cn-beijing-a	Zone source initiale (zone primaire) de la paire de réplication.
StandbyZone	String	cn-shanghai-b	Zone de destination initiale (zone secondaire) de la paire de réplication.
ChargeType	String	PREPAY	Méthode de facturation de la paire de réplication. Valeurs valides : PREPAY : abonnement POSTPAY : paiement à l'utilisation
ExpiredTime	Long	1649750977	Horodatage de l'expiration de la paire de réplication. Unité : secondes. 86 400 secondes équivalent à 24 heures.
Tags	Array of Tag		Tags de la paire de réplication.
TagKey	String	testKey	Clé du tag de la paire de réplication.
TagValue	String	testValue	Valeur du tag de la paire de réplication.
ResourceGroupId	String	rg-acfmvs*****	ID du groupe de ressources auquel la paire de réplication est attribuée.
PageNumber	Integer	1	Numéro de page.
PageSize	Integer	10	Nombre d'entrées par page.
TotalCount	Long	60	Nombre total d'entrées renvoyées.

Exemples

Exemple de requête

http(s)://ebs.cn-beijing.aliyuncs.com/?Action=DescribeDiskReplicaPairs
&RegionId=cn-beijing
&MaxResults=1
&NextToken=AAAAAdDWBF2****
&PairIds=pair-cn-dsa****
&Site=production
&ReplicaGroupId=pg-xxxx****
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<DescribeDiskReplicaPairsResponse>
    <RequestId>AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****</RequestId>
    <NextToken>AAAAAdDWBF2****</NextToken>
    <ReplicaPairs>
        <ReplicaPairId>pair-cn-dsa****</ReplicaPairId>
        <SourceRegion>cn-beijing</SourceRegion>
        <SourceZoneId>cn-beijing-a</SourceZoneId>
        <SourceDiskId>d-bp131n0q38u3a4zi****</SourceDiskId>
        <DestinationRegion>cn-shanghai</DestinationRegion>
        <DestinationZoneId>cn-shanghai-b</DestinationZoneId>
        <DestinationDiskId>d-asdfjl2342kj2l3k4****</DestinationDiskId>
        <PairName>TestReplicaPair</PairName>
        <Description>This is description.</Description>
        <Status>created</Status>
        <RPO>900</RPO>
        <Bandwidth>10240</Bandwidth>
        <StatusMessage>PrePayOrderExpired</StatusMessage>
        <LastRecoverPoint>1649751977</LastRecoverPoint>
        <ReplicaGroupId>pg-xxxx****</ReplicaGroupId>
        <CreateTime>1649750977</CreateTime>
        <ReplicaGroupName>pg-name****</ReplicaGroupName>
        <Site>production</Site>
        <PrimaryRegion>cn-beijing</PrimaryRegion>
        <StandbyRegion>cn-shanghai</StandbyRegion>
        <PrimaryZone>cn-beijing-a</PrimaryZone>
        <StandbyZone>cn-shanghai-b</StandbyZone>
        <ChargeType>PREPAY</ChargeType>
        <ExpiredTime>1649750977</ExpiredTime>
        <ResourceGroupId>rg-acfmvs*****</ResourceGroupId>
        <Tags>
            <TagKey>testKey</TagKey>
            <TagValue>testValue</TagValue>
        </Tags>
    </ReplicaPairs>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <TotalCount>60</TotalCount>
</DescribeDiskReplicaPairsResponse>

JSON format

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

{
  "RequestId" : "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
  "NextToken" : "AAAAAdDWBF2****",
  "ReplicaPairs" : [ {
    "ReplicaPairId" : "pair-cn-dsa****",
    "SourceRegion" : "cn-beijing",
    "SourceZoneId" : "cn-beijing-a",
    "SourceDiskId" : "d-bp131n0q38u3a4zi****",
    "DestinationRegion" : "cn-shanghai",
    "DestinationZoneId" : "cn-shanghai-b",
    "DestinationDiskId" : "d-asdfjl2342kj2l3k4****",
    "PairName" : "TestReplicaPair",
    "Description" : "This is description.",
    "Status" : "created",
    "RPO" : 900,
    "Bandwidth" : 10240,
    "StatusMessage" : "PrePayOrderExpired",
    "LastRecoverPoint" : 1649751977,
    "ReplicaGroupId" : "pg-xxxx****",
    "CreateTime" : 1649750977,
    "ReplicaGroupName" : "pg-name****",
    "Site" : "production",
    "PrimaryRegion" : "cn-beijing",
    "StandbyRegion" : "cn-shanghai",
    "PrimaryZone" : "cn-beijing-a",
    "StandbyZone" : "cn-shanghai-b",
    "ChargeType" : "PREPAY",
    "ExpiredTime" : 1649750977,
    "ResourceGroupId" : "rg-acfmvs*****",
    "Tags" : [ {
      "TagKey" : "testKey",
      "TagValue" : "testValue"
    } ]
  } ],
  "PageNumber" : 1,
  "PageSize" : 10,
  "TotalCount" : 60
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
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.	Vous ne pouvez pas effectuer cette opération sur la ressource dans son état actuel.
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 de votre compte Alibaba Cloud.
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 de votre 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.