DescribeDiskReplicaPairs - - Centro de documentación de Alibaba Cloud

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

Notas de uso

Para obtener información sobre las regiones donde está disponible la replicación asíncrona, consulte Descripción general.
Al invocar esta operación para una región específica, si el disco principal (disco de origen) o el disco secundario (disco de destino) de un par de replicación se encuentra dentro de dicha región, la respuesta incluirá la información del par de replicación.
Si desea realizar una consulta paginada, configure los parámetros NextToken y MaxResults. Durante una consulta paginada, al invocar la operación DescribeDiskReplicaPairs para obtener la primera página de resultados, establezca MaxResults para limitar el número máximo de entradas que se devolverán en la llamada. El valor devuelto por NextToken es un token de paginación que puede utilizar en la siguiente llamada para recuperar una nueva página de resultados. Cuando invoque la operación DescribeDiskReplicaPairs para obtener una nueva página de resultados, establezca NextToken con el valor de NextToken devuelto en la llamada anterior y defina 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 invocar 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í	DescribeDiskReplicaPairs	La operación que desea ejecutar. Establezca el valor en DescribeDiskReplicaPairs.
RegionId	String	Sí	cn-beijing	El ID de región del disco principal o secundario en el par de replicación. Puede invocar la operación DescribeRegions para consultar la lista más reciente de regiones compatibles con la replicación asíncrona.
MaxResults	Long	No	1	El número máximo de entradas que se devolverán. Puede usar este parámetro junto con NextToken. Valores válidos: 1 a 500. Valor predeterminado: 10.
NextToken	String	No	AAAAAdDWBF2****	El token de paginación que se usa en la siguiente solicitud para recuperar una nueva página de resultados. No necesita especificar este parámetro en la primera solicitud. Debe especificar el token obtenido de la consulta anterior como valor de NextToken. Cuando especifica NextToken, los parámetros de solicitud PageSize y PageNumber no surten efecto y el parámetro de respuesta TotalCount no es válido.
PairIds	String	No	pair-cn-dsa****	Los ID de los pares de replicación. Puede especificar los ID de uno o más pares de replicación. Separe los ID con comas (,). Ejemplo: `pair-cn-dsa,pair-cn-asd`. Este parámetro está vacío de forma predeterminada, lo que indica que se consultan todos los pares de replicación en la región especificada. Puede introducir hasta 100 ID de pares de replicación.
Site	String	No	production	El tipo de sitio desde el cual se recupera la información de los pares de replicación. Valores válidos: production: sitio principal backup: sitio secundario Valor predeterminado: production.
ReplicaGroupId	String	No	pg-****	El ID del grupo consistente de pares de replicación. Puede especificar el ID de un grupo consistente de pares de replicación para consultar los pares de replicación agregados a este grupo. Ejemplo: `pg-**`. Este parámetro está vacío de forma predeterminada, lo que indica que se consultan todos los pares de replicación en la región especificada. Nota** Si establece este parámetro en `-`, se consultarán los pares de replicación que no están agregados a grupos consistentes de pares de replicación.
PageNumber	Integer	No	5	El número de página.
PageSize	Integer	No	10	El número de entradas por página. Valores válidos: 1 a 100.
ResourceGroupId	String	No	rg-acfmvs******	El ID del resource group al que se asignará el par de replicación.
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N del par de replicación.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N del par de replicación.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****	El ID de la solicitud.
NextToken	String	AAAAAdDWBF2****	Un token de paginación. Se puede usar en la siguiente solicitud para recuperar una nueva página de resultados. Si NextToken está vacío, no existe una página siguiente.
ReplicaPairs	Array of ReplicaPair		Detalles de los pares de replicación.
ReplicaPairId	String	pair-cn-dsa****	El ID del par de replicación.
SourceRegion	String	cn-beijing	El ID de región del disco principal.
SourceZoneId	String	cn-beijing-a	El ID de zona del disco principal.
SourceDiskId	String	d-bp131n0q38u3a4zi****	El ID del disco principal.
DestinationRegion	String	cn-shanghai	El ID de región del disco secundario.
DestinationZoneId	String	cn-shanghai-b	El ID de zona del disco secundario.
DestinationDiskId	String	d-asdfjl2342kj2l3k4****	El ID del disco secundario.
PairName	String	TestReplicaPair	El nombre del par de replicación.
Description	String	This is description.	La descripción del par de replicación.
Status	String	created	El estado del par de replicación. Valores válidos: invalid: El par de replicación no es válido. Un par de replicación entra en este estado cuando presenta anomalías. creating: El par de replicación se estaba creando. created: El par de replicación fue creado. create_failed: Error al crear el par de replicación. initial_syncing: Los datos se sincronizaron del disco principal al disco secundario por primera vez. Después de crear y activar un par de replicación, este entra en dicho estado la primera vez que se sincronizan datos del disco principal al secundario. manual_syncing: Los datos se estaban sincronizando manualmente del disco principal al secundario. Tras sincronizar manualmente los datos del disco principal al secundario, el par de replicación vuelve al estado Stopped. La primera vez que se sincronizan datos manualmente del disco principal al secundario, el par de replicación permanece en el estado manual_syncing durante la sincronización. syncing: Los datos se estaban sincronizando del disco principal al secundario. Mientras los datos se replican asincrónicamente del disco principal al secundario (y no es la primera vez), el par de replicación se encuentra en este estado. normal: El par de replicación funcionaba correctamente. Cuando el sistema termina de replicar datos del disco principal al secundario dentro del ciclo de replicación actual, el par entra en este estado. stopping: El par de replicación se estaba deteniendo. stopped: El par de replicación estaba detenido. stop_failed: Error al detener el par de replicación. failovering: Se estaba realizando un failover. failovered: Se realizó un failover. failover_failed: Error al realizar el failover. reprotecting: Se estaba realizando una replicación inversa. reprotect_failed: Error al realizar la replicación inversa. deleting: El par de replicación se estaba eliminando. delete_failed: Error al eliminar el par de replicación. deleted: El par de replicación fue eliminado.
RPO	Long	900	El objetivo de punto de recuperación (RPO) del par de replicación. Unidad: segundos. 86,400 segundos equivalen a 24 horas.
Bandwidth	Long	10240	El ancho de banda utilizado para replicar asincrónicamente los datos del disco principal al secundario. Unidad: Kbit/s.
StatusMessage	String	PrePayOrderExpired	El mensaje que describe el estado del par de replicación. Este parámetro tiene un valor cuando `Status` tiene el valor invalid o `create_failed`. Valores válidos: PrePayOrderExpired: El par de replicación ha caducado. PostPayOrderCeaseService: El par de replicación pay-as-you-go se detuvo debido a un pago pendiente. DeviceRemoved: Se eliminó el disco principal o secundario. DeviceKeyChanged: La asignación `DeviceKey` del disco principal o secundario cambió. DeviceSizeChanged: El valor `DeviceSize` del disco principal o secundario cambió. OperationDenied.QuotaExceed: Se alcanzó el número máximo de pares de replicación que se pueden crear.
LastRecoverPoint	Long	1649751977	La hora en que se replicaron datos por última vez del disco principal al secundario en el par de replicación. El valor de este parámetro es una marca de tiempo. Unidad: segundos. 86,400 segundos equivalen a 24 horas.
ReplicaGroupId	String	pg-xxxx****	El ID del grupo consistente de pares de replicación al que pertenece el par de replicación.
CreateTime	Long	1649750977	La hora en que se creó el par de replicación. El valor de este parámetro es una marca de tiempo. Unidad: segundos. 86,400 segundos equivalen a 24 horas.
ReplicaGroupName	String	pg-name****	El nombre del grupo consistente de pares de replicación al que pertenece el par de replicación.
Site	String	production	El tipo de sitio desde el cual se obtuvo la información sobre los pares de replicación y el grupo consistente de pares de replicación. Valores válidos: production: sitio principal backup: sitio secundario
PrimaryRegion	String	cn-beijing	La región de origen inicial (región principal) del par de replicación.
StandbyRegion	String	cn-shanghai	La región de destino inicial (región secundaria) del par de replicación.
PrimaryZone	String	cn-beijing-a	La zona de origen inicial (zona principal) del par de replicación.
StandbyZone	String	cn-shanghai-b	La zona de destino inicial (zona secundaria) del par de replicación.
ChargeType	String	PREPAY	El método de facturación del par de replicación. Valores válidos: PREPAY: suscripción POSTPAY: pay-as-you-go
ExpiredTime	Long	1649750977	La hora en que caduca el par de replicación. El valor de este parámetro es una marca de tiempo. Unidad: segundos. 86,400 segundos equivalen a 24 horas.
Tags	Array of Tag		Las etiquetas del par de replicación.
TagKey	String	testKey	La clave de etiqueta del par de replicación.
TagValue	String	testValue	El valor de etiqueta del par de replicación.
ResourceGroupId	String	rg-acfmvs*****	El ID del resource group al que se asignará el par de replicación.
PageNumber	Integer	1	El número de página.
PageSize	Integer	10	El número de entradas por página.
TotalCount	Long	60	El número total de entradas devueltas.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

Formato XML

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>

Formato JSON

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
}

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 puede ejecutar esta operación.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	No puede ejecutar esta operación en el recurso mientras se encuentra en el estado actual.
403	Forbidden	User is not authorized to operate.	No tiene los permisos necesarios para ejecutar esta operación en 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 consultar una lista de códigos de error, consulte Códigos de error del servicio.