DescribeDiskReplicaGroups - - Centre de documentation Alibaba Cloud

Interroge les détails d'un ou plusieurs groupes de paires de réplication cohérents dans une région.

Notes d'utilisation

Pour effectuer une requête paginée, spécifiez MaxResults et NextToken.

Lors d'une requête paginée, lorsque vous appelez l'opération DescribeDiskReplicaGroups pour récupérer la première page de résultats, définissez MaxResults afin de spécifier le nombre maximal d'entrées à renvoyer lors de l'appel. La valeur de retour de NextToken est un jeton de pagination, qui peut être utilisé dans l'appel suivant pour récupérer une nouvelle page de résultats. Lorsque vous appelez l'opération DescribeDiskReplicaGroups pour récupérer une nouvelle page de résultats, définissez NextToken sur la valeur NextToken renvoyée lors de l'appel précédent et définissez MaxResults pour spécifier le nombre maximal d'entrées à renvoyer lors de cet appel.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de 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

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeDiskReplicaGroups	L'opération que vous souhaitez effectuer. Définissez la valeur sur DescribeDiskReplicaGroups.
RegionId	String	Yes	cn-beijing	L'ID de région du groupe de paires de réplication cohérent.
MaxResults	Long	No	10	Le nombre maximal d'entrées par page. Valeurs valides : 1 à 500. Valeur par défaut : 10.
NextToken	String	No	AAAAAdDWBF2****	Le jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats. Vous n'avez pas besoin de spécifier ce paramètre pour la première requête. Vous devez spécifier le jeton obtenu à partir de la requête précédente comme valeur de NextToken. Lorsque NextToken est spécifié, les paramètres de requête PageSize et PageNumber ne prennent pas effet et le paramètre de réponse TotalCount n'est pas valide.
GroupIds	String	No	AAAAAdDWBF2****	Les ID des groupes de paires de réplication cohérents. Vous pouvez spécifier les ID d'un maximum de 100 groupes de paires de réplication cohérents. Séparez les ID par des virgules (,). Ce paramètre est vide par défaut, ce qui indique que tous les groupes de paires de réplication cohérents de la région spécifiée sont interrogés.
Site	String	No	production	Le type de site à partir duquel les informations des groupes de paires de réplication cohérents sont récupérées. Ce paramètre est utilisé pour les scénarios où les données sont répliquées entre les zones dans les paires de réplication. Si ce paramètre n'est pas spécifié, les informations telles que l'état des groupes de paires de réplication cohérents sur le site principal sont interrogées et renvoyées. Si ce paramètre est spécifié, les informations telles que l'état des groupes de paires de réplication cohérents sur le site spécifié par ce paramètre sont interrogées et renvoyées. Valeurs valides : production : site principal backup : site secondaire
PageNumber	Integer	No	5	Le numéro de page.
PageSize	Integer	No	10	Le nombre d'entrées par page. Valeurs valides : 1 à 100.
ResourceGroupId	String	No	rg-aekz*****	L'ID du groupe de ressources auquel appartient le groupe de paires de réplication cohérent.
Tag.N.Key	String	No	tag-key	La clé du tag N du groupe de paires de réplication cohérent.
Tag.N.Value	String	No	tag-value	La valeur du tag N du groupe de paires de réplication cohérent.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****	L'ID de la requête.
NextToken	String	AAAAAdDWBF2****	Un jeton de pagination. Il peut être utilisé dans la requête suivante pour récupérer une nouvelle page de résultats.
ReplicaGroups	Array of ReplicaGroup		Les informations relatives aux groupes de paires de réplication cohérents.
ReplicaGroupId	String	pg-myreplica****	L'ID du groupe de paires de réplication cohérent.
SourceRegionId	String	cn-beijing	L'ID de région du site principal.
SourceZoneId	String	cn-beijing-f	L'ID de zone du site principal.
DestinationRegionId	String	cn-shanghai	L'ID de région du site secondaire.
DestinationZoneId	String	cn-shanghai-e	L'ID de zone du site secondaire.
GroupName	String	myreplicagrouptest	Le nom du groupe de paires de réplication cohérent.
Description	String	This is description.	La description du groupe de paires de réplication cohérent.
Status	String	created	L'état du groupe de paires de réplication cohérent. Valeurs valides : invalid : Le groupe de paires de réplication cohérent n'est pas valide, ce qui indique que des paires de réplication anormales sont présentes dans le groupe de paires de réplication cohérent. creating : Le groupe de paires de réplication cohérent est en cours de création. created : Le groupe de paires de réplication cohérent est créé. create_failed : Le groupe de paires de réplication cohérent ne peut pas être créé. manual_syncing : Les données sont synchronisées manuellement entre les disques du groupe de paires de réplication cohérent. La première fois que les données sont synchronisées manuellement entre les disques d'un groupe de paires de réplication cohérent, le groupe de paires de réplication cohérent se trouve dans cet état. syncing : Les données sont synchronisées entre les disques du groupe de paires de réplication cohérent. Lorsque les données sont répliquées de manière asynchrone des disques principaux vers les disques secondaires, sauf pour la première fois, le groupe de paires de réplication cohérent se trouve dans cet état. normal : Le groupe de paires de réplication cohérent fonctionne comme prévu. Lorsque le système termine la réplication des données des disques principaux vers les disques secondaires au sein du cycle de réplication actuel, le groupe de paires de réplication cohérent passe à cet état. stopping : Le groupe de paires de réplication cohérent est en cours d'arrêt. stopped : Le groupe de paires de réplication cohérent est arrêté. stop_failed : Le groupe de paires de réplication cohérent ne peut pas être arrêté. failovering : Un basculement est en cours. failovered : Un basculement a été effectué. failover_failed : Un basculement ne peut pas être effectué. reprotecting : Une réplication inverse est en cours. reprotect_failed : Une réplication inverse ne peut pas être effectuée. deleting : Le groupe de paires de réplication cohérent est en cours de suppression. delete_failed : Le groupe de paires de réplication cohérent ne peut pas être supprimé. deleted : Le groupe de paires de réplication cohérent est supprimé.
RPO	Long	180	L'objectif de point de récupération (RPO) du groupe de paires de réplication cohérent. Unité : secondes.
LastRecoverPoint	Long	1637835114	L'heure à laquelle les données ont été dernières répliquées des disques principaux vers les disques secondaires dans le groupe de paires de réplication cohérent. La valeur de ce paramètre est un horodatage. Unité : secondes.
Site	String	production	Le type de site à partir duquel les informations de la paire de réplication et du groupe de paires de réplication cohérent sont obtenues. Valeurs valides : production : site principal backup : site secondaire
PairIds	Array of String	pair-cn-dsa**,pair-cn-asd**	Les ID des paires de réplication qui appartiennent au groupe de paires de réplication cohérent.
PairNumber	Long	2	Le nombre de paires de réplication qui appartiennent au groupe de paires de réplication cohérent.
PrimaryRegion	String	cn-beijing	La région source initiale (région principale) du groupe de paires de réplication cohérent.
StandbyRegion	String	cn-shanghai	La région de destination initiale (région secondaire) du groupe de paires de réplication cohérent.
PrimaryZone	String	cn-beijing-h	La zone source initiale (zone principale) du groupe de paires de réplication cohérent.
StandbyZone	String	cn-shanghai-e	La zone de destination initiale (zone secondaire) du groupe de paires de réplication cohérent.
Bandwidth	Long	0	La valeur de la bande passante. Unité : Mbit/s. Ce paramètre n'est pas disponible publiquement et possède une valeur prédéfinie par le système.
ResourceGroupId	String	rg-aek2a*******	L'ID du groupe de ressources auquel appartient le groupe de paires de réplication cohérent.
Tags	Array of Tag		Les tags du groupe de paires de réplication cohérent.
TagKey	String	testKey	La clé de tag du groupe de paires de réplication cohérent.
TagValue	String	testValue	La valeur de tag du groupe de paires de réplication cohérent.
PageNumber	Integer	1	Le numéro de page.
PageSize	Integer	10	Le nombre d'entrées par page.
TotalCount	Long	60	Le nombre total d'entrées renvoyées.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=DescribeDiskReplicaGroups
&RegionId=cn-beijing
&MaxResults=10
&NextToken=AAAAAdDWBF2****
&GroupIds=AAAAAdDWBF2****
&Site=production
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<DescribeDiskReplicaGroupsResponse>
    <RequestId>AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****</RequestId>
    <NextToken>AAAAAdDWBF2****</NextToken>
    <ReplicaGroups>
        <ReplicaGroupId>pg-myreplica****</ReplicaGroupId>
        <SourceRegionId>cn-beijing</SourceRegionId>
        <SourceZoneId>cn-beijing-f</SourceZoneId>
        <DestinationRegionId>cn-shanghai</DestinationRegionId>
        <DestinationZoneId>cn-shanghai-e</DestinationZoneId>
        <GroupName>myreplicagrouptest</GroupName>
        <Description>This is description.</Description>
        <Status>created</Status>
        <RPO>180</RPO>
        <LastRecoverPoint>1637835114</LastRecoverPoint>
        <Site>production</Site>
        <PairIds>pair-cn-dsa****,pair-cn-asd****</PairIds>
        <PairNumber>2</PairNumber>
    </ReplicaGroups>
</DescribeDiskReplicaGroupsResponse>

Format JSON

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

{
  "RequestId" : "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
  "NextToken" : "AAAAAdDWBF2****",
  "ReplicaGroups" : [ {
    "ReplicaGroupId" : "pg-myreplica****",
    "SourceRegionId" : "cn-beijing",
    "SourceZoneId" : "cn-beijing-f",
    "DestinationRegionId" : "cn-shanghai",
    "DestinationZoneId" : "cn-shanghai-e",
    "GroupName" : "myreplicagrouptest",
    "Description" : "This is description.",
    "Status" : "created",
    "RPO" : 180,
    "LastRecoverPoint" : 1637835114,
    "Site" : "production",
    "PairIds" : [ "pair-cn-dsa****,pair-cn-asd****" ],
    "PairNumber" : 2
  } ]
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
403	OperationDenied	The operation is not allowed.	Cette opération ne peut pas être effectuée.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	Cette opération ne peut pas être effectuée sur le groupe de paires de réplication cohérent dans l'état actuel.
403	Forbidden	User is not authorized to operate.	Vous ne disposez pas des autorisations nécessaires pour gérer 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 les Codes d'erreur de service.