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

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

Descripción de la operación

Descripción

Para realizar una consulta paginada, puede utilizar los parámetros MaxResults y NextToken.

Cuando consulte la primera página, configure MaxResults para especificar el número de entradas que se devolverán. El valor NextToken en la respuesta es el token utilizado para consultar las páginas siguientes. Para consultar una página siguiente, configure NextToken con el valor de la respuesta anterior y configure MaxResults para especificar el número de entradas de la página actual.

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:DescribeDiskReplicaGroups

list

*DiskReplicaGroup

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

*DiskReplicaGroup

acs:ebs:{#regionId}:{#accountId}:diskreplicagroup/{#ReplicaGroupId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región del grupo consistente de pares de replicación.	cn-beijing
MaxResults	integer	No	El número máximo de entradas que se devolverán en una sola página. Puede utilizar este parámetro junto con NextToken. Valores válidos: 1 a 500. Valor predeterminado: 10.	10
NextToken	string	No	El token de consulta. Configure este parámetro con el valor NextToken devuelto en la llamada anterior a esta operación. No es necesario configurar este parámetro en 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****
GroupIds	string	No	Los ID de los grupos consistentes de pares de replicación. Puede especificar uno o más ID de grupo. Separe varios ID con una coma (,). Si no especifica este parámetro, se consultan todos los grupos consistentes de pares de replicación en la región actual. Puede especificar hasta 100 ID de grupo.	AAAAAdDWBF2****
Site	string	No	El sitio que se va a consultar. Este parámetro se utiliza cuando los pares de replicación están desplegados en varias zonas. Si no especifica este parámetro, se devuelven los registros y la información de estado de los pares de replicación en el sitio de producción. Si especifica este parámetro, solo se devuelven los registros y la información de estado de los pares de replicación en el sitio especificado. Valores válidos: production: El sitio de producción. backup: El sitio de recuperación ante desastres.	production
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 grupo consistente de pares de replicación.	rg-aekz*****
Name	string	No	El nombre del grupo de replicación. Se admite la búsqueda difusa.	pg-name***
Tag	array<object>	No	Las etiquetas. La lista puede contener hasta 20 etiquetas.
	object	No	La información de la etiqueta.
Value	string	No	El valor de la etiqueta del grupo consistente de pares de replicación.	tag-value
Key	string	No	La clave de la etiqueta del grupo consistente de pares de replicación.	tag-key

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****
ReplicaGroups	array<object>	La información sobre los grupos consistentes de pares de replicación.
	array<object>
GroupName	string	El nombre del grupo consistente de pares de replicación.	myreplicagrouptest
Site	string	El sitio del par de replicación y 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
Description	string	La descripción del grupo consistente de pares de replicación.	Esta es la descripción
StandbyZone	string	La zona de destino inicial del grupo de replicación.	cn-shanghai-e
ResourceGroupId	string	El ID del grupo de recursos al que pertenece el grupo de replicación.	rg-aek2a*******
LastRecoverPoint	integer	La hora en que se completó la última replicación asíncrona para el grupo consistente de pares de replicación. Este parámetro es una marca de tiempo UNIX. Unidad: segundos.	1637835114
ReplicaGroupId	string	El ID del grupo consistente de pares de replicación.	pg-myreplica****
RPO	integer	El objetivo de punto de recuperación (RPO) del grupo consistente de pares de replicación. Unidad: segundos.	180
SourceRegionId	string	El ID de la región del sitio de producción.	cn-beijing
DestinationRegionId	string	El ID de la región del sitio de recuperación ante desastres.	cn-shanghai
Bandwidth	integer	El ancho de banda. Unidad: Kbit/s. Este parámetro aún no está disponible. El valor devuelto está predefinido por el sistema.	0
PrimaryZone	string	La zona de origen inicial del grupo de replicación.	cn-beijing-h
SourceZoneId	string	El ID de la zona del sitio de producción.	cn-beijing-f
Tags	array<object>	Las etiquetas del grupo de replicación.
	object
TagKey	string	La clave de la etiqueta del grupo de replicación.	testKey
TagValue	string	El valor de la etiqueta del grupo de replicación.	testValue
Status	string	El 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. Este estado indica que un par de replicación en el grupo presenta anomalías. creating: El grupo consistente de pares de replicación se está creando. created: El grupo consistente de pares de replicación ha sido creado. create_failed: Error al crear el grupo consistente de pares de replicación. manual_syncing: El grupo consistente de pares de replicación está realizando una sincronización única. El grupo también se encuentra en este estado durante la primera sincronización única. syncing: El grupo consistente de pares de replicación está sincronizando datos. El grupo se encuentra en este estado cuando los datos se replican de forma asíncrona desde el disco principal al disco secundario en ocasiones posteriores. normal: Normal. Cuando la replicación de datos se completa en el ciclo de replicación asíncrona actual, el grupo se encuentra en este estado. stopping: El grupo consistente de pares de replicación se está deteniendo. stopped: El grupo consistente de pares de replicación está detenido. stop_failed: Error al detener el grupo consistente de pares de replicación. failovering: Se está realizando un failover. failovered: El failover se ha completado. failover_failed: Error en el failover. reprotecting: Se está realizando una replicación inversa. reprotect_failed: Error en la replicación inversa. deleting: El grupo consistente de pares de replicación se está eliminando. delete_failed: Error al eliminar el grupo consistente de pares de replicación. deleted: El grupo consistente de pares de replicación ha sido eliminado.	created
PairNumber	integer	El número de pares de replicación en el grupo consistente de pares de replicación.	2
PrimaryRegion	string	La región de origen inicial del grupo de replicación.	cn-beijing
PairIds	array	La lista de ID de pares de replicación en el grupo consistente de pares de replicación.
	string	Los ID de los pares de replicación en el grupo consistente de pares de replicación.	pair-cn-dsa**,pair-cn-asd**
EnableRtc	boolean	Especifica si se debe habilitar el control de tiempo de replicación (RTC). Valores válidos: false: Deshabilita RTC. true: Habilita RTC. Nota Si configura este parámetro como true, se habilita RTC para el grupo consistente de pares de replicación y para todos los pares de replicación asíncrona que se agreguen al grupo.	true
DestinationZoneId	string	El ID de la zona del sitio de recuperación ante desastres.	cn-shanghai-e
StandbyRegion	string	La región de destino inicial del grupo 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 devueltas.	60

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
  "NextToken": "AAAAAdDWBF2****",
  "ReplicaGroups": [
    {
      "GroupName": "myreplicagrouptest",
      "Site": "production",
      "Description": "This is description.",
      "StandbyZone": "cn-shanghai-e",
      "ResourceGroupId": "rg-aek2a*******",
      "LastRecoverPoint": 1637835114,
      "ReplicaGroupId": "pg-myreplica****",
      "RPO": 180,
      "SourceRegionId": "cn-beijing",
      "DestinationRegionId": "cn-shanghai",
      "Bandwidth": 0,
      "PrimaryZone": "cn-beijing-h",
      "SourceZoneId": "cn-beijing-f",
      "Tags": [
        {
          "TagKey": "testKey",
          "TagValue": "testValue"
        }
      ],
      "Status": "created",
      "PairNumber": 2,
      "PrimaryRegion": "cn-beijing",
      "PairIds": [
        "pair-cn-dsa****,pair-cn-asd****"
      ],
      "EnableRtc": true,
      "DestinationZoneId": "cn-shanghai-e",
      "StandbyRegion": "cn-shanghai\n"
    }
  ],
  "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.