DescribeDiskReplicaPairs - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Consulta información sobre uno o más pares de replicación en una región especificada.

Descripción de la operación

Descripción

Para obtener información sobre las regiones que admiten la replicación asíncrona, consulte Resumen de la replicación asíncrona para discos.
Si el disco principal o secundario de un par de replicación asíncrona se encuentra en la región especificada, la consulta devuelve información sobre ese par de replicación.
Para realizar una consulta paginada, utilice los parámetros MaxResults y NextToken. Para la primera página, configure MaxResults para limitar el número de entradas devueltas. El valor NextToken en la respuesta es el token para la siguiente página. Para las páginas subsiguientes, configure NextToken con el valor de la respuesta anterior y configure MaxResults para limitar el número de entradas.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ebs:DescribeDiskReplicaPairs

get

*DiskReplicaPair

acs:ebs:{#regionId}:{#accountId}:diskreplicapair/*

*DiskReplicaPair

acs:ebs:{#regionId}:{#accountId}:diskreplicapair/{#ReplicaPairId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región donde reside el disco principal o secundario del par de replicación. Llame a la operación DescribeRegions para consultar las regiones que admiten la replicación asíncrona.	cn-beijing
MaxResults	integer	No	El número máximo de entradas a devolver en cada página. Utilice este parámetro junto con NextToken. Valores válidos: 1 a 500. Valor predeterminado: 10.	1
NextToken	string	No	El token de consulta. Configure este parámetro con el valor de NextToken devuelto en la llamada anterior a esta operación. No necesita configurar este parámetro para la primera llamada. Si configura NextToken, los parámetros PageSize y PageNumber se ignoran, y el valor TotalCount en la respuesta no es válido.	AAAAAdDWBF2****
PairIds	string	No	Los ID de los pares de replicación. Especifique uno o más ID de pares de replicación. Los ID deben tener el formato `pair-cn-dsa**,pair-cn-asd**`. Si deja este parámetro vacío, se consultan todos los pares de replicación en la región actual. Puede especificar hasta 100 ID de pares de replicación.	pair-cn-dsa****
Site	string	No	El sitio desde el cual consultar datos. Consulte datos desde el sitio de producción o el sitio de recuperación ante desastres. Valores válidos: production: el sitio de producción. backup: el sitio de recuperación ante desastres. Valor predeterminado: production.	production
ReplicaGroupId	string	No	El ID del grupo consistente de pares de replicación. Especifique el ID de un grupo consistente de pares de replicación para consultar los pares de replicación en el grupo. El ID debe tener el formato `pg-**`. Si deja este parámetro vacío, se consultan todos los pares de replicación en la región actual. Nota** Si configura este parámetro como `-`, se devuelven los pares de replicación que no pertenecen a ningún grupo consistente de pares de replicación.	pg-****
PageNumber	integer	No	El número de página.	5
PageSize	integer	No	El número de entradas por página. Valores válidos: 1 a 100.	10
ResourceGroupId	string	No	El ID del grupo de recursos al que pertenece el par de replicación.	rg-acfmvs******
Name	string	No	El nombre del par de replicación. Se admite la coincidencia aproximada.	name***
Tag	array<object>	No	Las etiquetas. Puede especificar hasta 20 etiquetas.
	object	No	La etiqueta.
Value	string	No	El valor de la etiqueta.	TestValue
Key	string	No	La clave de la etiqueta.	TestKey

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El esquema de la respuesta.
RequestId	string	El ID de la solicitud.	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****
NextToken	string	El token de consulta devuelto en esta llamada.	AAAAAdDWBF2****
ReplicaPairs	array<object>	Los pares de replicación.
	array<object>
Site	string	El tipo de sitio del par de replicación o del grupo consistente de pares de replicación. Valores válidos: production: el sitio de producción. backup: el sitio de recuperación ante desastres.	production
DestinationDiskId	string	El ID del disco secundario.	d-asdfjl2342kj2l3k4****
Description	string	La descripción del par de replicación.	Esta es la descripción
StandbyZone	string	La zona de destino inicial del par de replicación.	cn-shanghai-b
ResourceGroupId	string	El ID del grupo de recursos al que pertenece el par de replicación.	rg-acfmvs*****
DestinationRegion	string	La región del disco secundario.	cn-shanghai
ReplicaPairId	string	El ID del par de replicación.	pair-cn-dsa****
LastRecoverPoint	integer	La hora en que se completó la última replicación asíncrona. Este valor es una marca de tiempo UNIX. Unidad: segundos.	1649751977
ReplicaGroupId	string	El ID del grupo consistente de pares de replicación al que pertenece el par de replicación.	pg-xxxx****
SourceDiskId	string	El ID del disco principal.	d-bp131n0q38u3a4zi****
RPO	integer	El objetivo de punto de recuperación (RPO) del par de replicación. Unidad: segundos.	900
PairName	string	El nombre del par de replicación.	TestReplicaPair
Bandwidth	integer	El ancho de banda utilizado para la replicación asíncrona. Unidad: Kbit/s.	10240
ExpiredTime	integer	La hora de vencimiento del par de replicación. Este valor es una marca de tiempo UNIX. Unidad: segundos.	1649750977
PrimaryZone	string	La zona de origen inicial del par de replicación.	cn-beijing-a
SourceZoneId	string	La zona del disco principal.	cn-beijing-a
Tags	array<object>	Las etiquetas del par de replicación.
	object	La etiqueta.
TagKey	string	La clave de la etiqueta.	testKey
TagValue	string	El valor de la etiqueta.	testValue
Status	string	El estado del par de replicación. Valores válidos: invalid: El par de replicación no es válido. Este estado indica que el par de replicación no funciona correctamente. creating: El par de replicación se está creando. created: El par de replicación está creado. create_failed: Error al crear el par de replicación. initial_syncing: El par de replicación se encuentra en estado de sincronización inicial. Después de crear e iniciar un par de replicación, entra en este estado durante la primera replicación asíncrona de datos del disco principal al disco secundario. manual_syncing: El par de replicación se está sincronizando manualmente. Una vez completada la sincronización manual, el par de replicación vuelve al estado detenido. Si es la primera sincronización única, el estado también es manual_syncing. syncing: El par de replicación está sincronizando datos. El par de replicación se encuentra en este estado cuando los datos se replican de forma asíncrona del disco principal al disco secundario por segunda vez o subsiguientes. normal: El par de replicación se encuentra en estado normal. El par de replicación entra en este estado cuando se completa la replicación de datos en el ciclo de replicación actual. stopping: El par de replicación se está deteniendo. stopped: El par de replicación está detenido. stop_failed: Error al detener el par de replicación. failovering: Hay una conmutación por error en curso. failovered: La conmutación por error se ha completado. failover_failed: Error en la conmutación por error. reprotecting: Hay una replicación inversa en curso. reprotect_failed: Error en la replicación inversa. deleting: El par de replicación se está eliminando. delete_failed: Error al eliminar el par de replicación. deleted: El par de replicación está eliminado.	created
PrimaryRegion	string	La región de origen inicial del par de replicación.	cn-beijing
CreateTime	integer	La hora de creación. Este valor es una marca de tiempo UNIX. Unidad: segundos.	1649750977
SourceRegion	string	La región del disco principal.	cn-beijing
StatusMessage	string	El mensaje de estado del par de replicación. Este parámetro se devuelve cuando el estado es `invalid` o `create_failed`. Valores válidos: PrePayOrderExpired: El par de replicación de suscripción ha vencido. PostPayOrderCeaseService: El servicio del par de replicación de pago por uso está suspendido, generalmente debido a un pago pendiente. DeviceRemoved: El disco principal o secundario ha sido eliminado. DeviceKeyChanged: La asignación `DeviceKey` del disco principal o secundario ha cambiado. DeviceSizeChanged: El `DeviceSize` del disco principal o secundario ha cambiado. OperationDenied.QuotaExceed: El número de pares de replicación creados supera la cuota.	PrePayOrderExpired
EnableRtc	boolean	Especifica si el control en tiempo real (RTC) está habilitado. Valores válidos: false: Deshabilitado. true: Habilitado. Nota Si el par de replicación pertenece a un grupo consistente de pares de replicación, el valor de este parámetro es el mismo que el del grupo.
ChargeType	string	El método de facturación del par de replicación. Valores válidos: PREPAY: suscripción. POSTPAY: pago por uso.	PREPAY
DestinationZoneId	string	La zona del disco secundario.	cn-shanghai-b
ReplicaGroupName	string	El nombre del grupo consistente de pares de replicación al que pertenece el par de replicación.	pg-name****
StandbyRegion	string	La región de destino inicial del par de replicación.	cn-shanghai
PageNumber	integer	El número de página.	1
PageSize	integer	El número de entradas por página.	10
TotalCount	integer	El número total de entradas.	60

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred.
403	OperationDenied	The operation is not allowed.	The operation is not supported.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	The operation is not supported in the current state.
403	Forbidden	User is not authorized to operate.	You are not authorized to manage the resource. Check the account permissions or contact the Alibaba Cloud account.
403	Forbidden.Action	User is not authorized to operate this action.	You are not authorized to perform this operation. Check the account permissions or contact the Alibaba Cloud account.
404	NoSuchResource	The specified resource does not exist.	The specified resource does not exist.
504	RequestTimeout	The request is timeout, please try again later.	The request has timed out. Try again later.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.