DescribeDiskReplicaGroups - - Centro de documentación de Alibaba Cloud

Consulta los detalles de uno o más grupos consistentes de pares de replicación en una región.

Notas de uso

Para consultar con paginación, especifique MaxResults y NextToken.

Durante una consulta paginada, cuando llame a la operación DescribeDiskReplicaGroups para obtener la primera página de resultados, establezca MaxResults para indicar el número máximo de entradas que se devolverán en la llamada. El valor devuelto de NextToken es un token de paginación que puede utilizar en la siguiente llamada para recuperar una nueva página de resultados. Cuando llame a la operación DescribeDiskReplicaGroups para obtener una nueva página de resultados, asigne a NextToken el valor de NextToken devuelto en la llamada anterior y configure MaxResults para especificar el número máximo de entradas que se devolverán en esta llamada.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeDiskReplicaGroups	La operación que desea ejecutar. Establezca el valor en DescribeDiskReplicaGroups.
RegionId	String	Sí	cn-beijing	El ID de región del grupo consistente de pares de replicación.
MaxResults	Long	No	10	El número máximo de entradas por página. Valores válidos: de 1 a 500. Valor predeterminado: 10.
NextToken	String	No	AAAAAdDWBF2****	Token de paginación que se utiliza en la siguiente solicitud para recuperar una nueva página de resultados. No es necesario especificar este parámetro en la primera solicitud. Debe especificar el token obtenido de la consulta anterior como valor de NextToken. Si especifica NextToken, los parámetros de solicitud PageSize y PageNumber no surten efecto y el parámetro de respuesta TotalCount no es válido.
GroupIds	String	No	AAAAAdDWBF2****	Los ID de los grupos consistentes de pares de replicación. Puede especificar hasta 100 ID de grupos consistentes de pares de replicación. Separe los ID con comas (,). De forma predeterminada, este parámetro está vacío, lo que indica que se consultan todos los grupos consistentes de pares de replicación en la región especificada.
Site	String	No	production	Tipo de sitio desde el cual se recupera la información de los grupos consistentes de pares de replicación. Este parámetro se utiliza en escenarios donde los datos se replican entre zonas en pares de replicación. Si no se especifica este parámetro, se consulta y devuelve información como el estado de los grupos consistentes de pares de replicación en el sitio principal. Si se especifica este parámetro, se consulta y devuelve información como el estado de los grupos consistentes de pares de replicación en el sitio indicado. Valores válidos: production: sitio principal backup: sitio secundario
PageNumber	Integer	No	5	Número de página.
PageSize	Integer	No	10	Número de entradas por página. Valores válidos: de 1 a 100.
ResourceGroupId	String	No	rg-aekz*****	ID del resource group al que pertenece el grupo consistente de pares de replicación.
Tag.N.Key	String	No	tag-key	Clave de la etiqueta N del grupo consistente de pares de replicación.
Tag.N.Value	String	No	tag-value	Valor de la etiqueta N del grupo consistente de pares de replicación.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****	ID de la solicitud.
NextToken	String	AAAAAdDWBF2****	Token de paginación. Se puede utilizar en la siguiente solicitud para recuperar una nueva página de resultados.
ReplicaGroups	Array of ReplicaGroup		Información sobre los grupos consistentes de pares de replicación.
ReplicaGroupId	String	pg-myreplica****	ID del grupo consistente de pares de replicación.
SourceRegionId	String	cn-beijing	ID de región del sitio principal.
SourceZoneId	String	cn-beijing-f	ID de zona del sitio principal.
DestinationRegionId	String	cn-shanghai	ID de región del sitio secundario.
DestinationZoneId	String	cn-shanghai-e	ID de zona del sitio secundario.
GroupName	String	myreplicagrouptest	Nombre del grupo consistente de pares de replicación.
Description	String	This is description.	Descripción del grupo consistente de pares de replicación.
Status	String	created	Estado del grupo consistente de pares de replicación. Valores válidos: invalid: El grupo consistente de pares de replicación no es válido, lo que indica que hay pares de replicación anómalos en el grupo. creating: Se está creando el grupo consistente de pares de replicación. created: El grupo consistente de pares de replicación se creó correctamente. create_failed: No se pudo crear el grupo consistente de pares de replicación. manual_syncing: Se están sincronizando manualmente los datos entre los discos del grupo consistente de pares de replicación. El grupo entra en este estado la primera vez que se sincronizan manualmente los datos entre sus discos. syncing: Se están sincronizando los datos entre los discos del grupo consistente de pares de replicación. El grupo entra en este estado cuando los datos se replican de forma asíncrona desde los discos principales hacia los discos secundarios y no es la primera vez que ocurre. normal: El grupo consistente de pares de replicación funciona según lo esperado. El grupo entra en este estado cuando el sistema termina de replicar los datos de los discos principales a los secundarios dentro del ciclo de replicación actual. stopping: Se está deteniendo el grupo consistente de pares de replicación. stopped: El grupo consistente de pares de replicación está detenido. stop_failed: No se pudo detener el grupo consistente de pares de replicación. failovering: Se está ejecutando un failover. failovered: Se completó un failover. failover_failed: No se pudo ejecutar el failover. reprotecting: Se está ejecutando una replicación inversa. reprotect_failed: No se pudo ejecutar la replicación inversa. deleting: Se está eliminando el grupo consistente de pares de replicación. delete_failed: No se pudo eliminar el grupo consistente de pares de replicación. deleted: El grupo consistente de pares de replicación se eliminó.
RPO	Long	180	Objetivo de punto de recuperación (RPO) del grupo consistente de pares de replicación. Unidad: segundos.
LastRecoverPoint	Long	1637835114	Hora en que se replicaron por última vez los datos desde los discos principales hacia los discos secundarios en el grupo consistente de pares de replicación. El valor de este parámetro es una marca de tiempo. Unidad: segundos.
Site	String	production	Tipo de sitio desde el cual se obtiene la información del par de replicación y del grupo consistente de pares de replicación. Valores válidos: production: sitio principal backup: sitio secundario
PairIds	Array of String	pair-cn-dsa**,pair-cn-asd**	ID de los pares de replicación que pertenecen al grupo consistente de pares de replicación.
PairNumber	Long	2	Número de pares de replicación que pertenecen al grupo consistente de pares de replicación.
PrimaryRegion	String	cn-beijing	Región de origen inicial (región principal) del grupo consistente de pares de replicación.
StandbyRegion	String	cn-shanghai	Región de destino inicial (región secundaria) del grupo consistente de pares de replicación.
PrimaryZone	String	cn-beijing-h	Zona de origen inicial (zona principal) del grupo consistente de pares de replicación.
StandbyZone	String	cn-shanghai-e	Zona de destino inicial (zona secundaria) del grupo consistente de pares de replicación.
Bandwidth	Long	0	Valor de ancho de banda. Unidad: Mbit/s. Este parámetro no es público y tiene un valor preestablecido por el sistema.
ResourceGroupId	String	rg-aek2a*******	ID del resource group al que pertenece el grupo consistente de pares de replicación.
Tags	Array of Tag		Etiquetas del grupo consistente de pares de replicación.
TagKey	String	testKey	Clave de etiqueta del grupo consistente de pares de replicación.
TagValue	String	testValue	Valor de etiqueta del grupo consistente de pares de replicación.
PageNumber	Integer	1	Número de página.
PageSize	Integer	10	Número de entradas por página.
TotalCount	Long	60	Número total de entradas devueltas.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato 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>

Formato 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
  } ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
403	OperationDenied	The operation is not allowed.	No se puede ejecutar esta operación.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	No se puede ejecutar esta operación en el grupo consistente de pares de replicación debido a su estado actual.
403	Forbidden	User is not authorized to operate.	No tiene permisos para gestionar el recurso. Compruebe los permisos de su cuenta o póngase en contacto con el administrador de su cuenta de Alibaba Cloud.
403	Forbidden.Action	User is not authorized to operate this action.	No tiene acceso a esta operación. Compruebe los permisos de su cuenta o póngase en contacto con el administrador de su cuenta de Alibaba Cloud.
404	NoSuchResource	The specified resource does not exist.	No se encontró el recurso especificado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno.
504	RequestTimeout	The request is timeout, please try again later.	La solicitud agotó el tiempo de espera. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.