DescribeDiskReplicaGroups - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Consulta informações sobre um ou mais grupos consistentes de pares de replicação em uma região especificada.

Descrição da operação

Descrição

Para realizar uma consulta paginada, você pode usar os parâmetros MaxResults e NextToken.

Ao consultar a primeira página, defina MaxResults para especificar o número de entradas a serem retornadas. O valor NextToken na resposta é o token usado para consultar as páginas subsequentes. Para consultar uma página subsequente, defina NextToken com o valor da resposta anterior e defina MaxResults para especificar o número de entradas da página atual.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ebs:DescribeDiskReplicaGroups

list

*DiskReplicaGroup

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

*DiskReplicaGroup

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do grupo consistente de pares de replicação.	cn-beijing
MaxResults	integer	Não	O número máximo de entradas a serem retornadas em uma única página. Você pode usar este parâmetro com NextToken. Valores válidos: 1 a 500. Valor padrão: 10.	10
NextToken	string	Não	O token de consulta. Defina este parâmetro com o valor NextToken retornado da chamada anterior a esta operação. Você não precisa definir este parâmetro na primeira chamada. Se você definir NextToken, os parâmetros PageSize e PageNumber serão ignorados e o TotalCount na resposta será inválido.	AAAAAdDWBF2****
GroupIds	string	Não	Os IDs dos grupos consistentes de pares de replicação. Você pode especificar um ou mais IDs de grupo. Separe vários IDs com uma vírgula (,). Se você não especificar este parâmetro, todos os grupos consistentes de pares de replicação na região atual serão consultados. Você pode especificar até 100 IDs de grupo.	AAAAAdDWBF2****
Site	string	Não	O site a ser consultado. Este parâmetro é usado quando os pares de replicação são implantados em zonas diferentes. Se você não especificar este parâmetro, os registros e as informações de status dos pares de replicação no site de produção serão retornados. Se você especificar este parâmetro, apenas os registros e as informações de status dos pares de replicação no site especificado serão retornados. Valores válidos: production: O site de produção. backup: O site de recuperação de desastres.	production
PageNumber	integer	Não	O número da página.	5
PageSize	integer	Não	O número de entradas por página. Valores válidos: 1 a 100.	10
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o grupo consistente de pares de replicação pertence.	rg-aekz*****
Name	string	Não	O nome do grupo de replicação. Há suporte para pesquisa aproximada.	pg-name***
Tag	array<object>	Não	As tags. A lista pode conter até 20 tags.
	object	Não	As informações sobre a tag.
Value	string	Não	O valor da tag do grupo consistente de pares de replicação.	tag-value
Key	string	Não	A chave da tag do grupo consistente de pares de replicação.	tag-key

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O esquema da resposta.
RequestId	string	O ID da solicitação.	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****
NextToken	string	O token de consulta retornado nesta chamada.	AAAAAdDWBF2****
ReplicaGroups	array<object>	As informações sobre os grupos consistentes de pares de replicação.
	array<object>
GroupName	string	O nome do grupo consistente de pares de replicação.	myreplicagrouptest
Site	string	O site do par de replicação e do grupo consistente de pares de replicação. Valores válidos: production: O site de produção. backup: O site de recuperação de desastres.	production
Description	string	A descrição do grupo consistente de pares de replicação.	This is description.
StandbyZone	string	A zona de destino inicial do grupo de replicação.	cn-shanghai-e
ResourceGroupId	string	O ID do grupo de recursos ao qual o grupo de replicação pertence.	rg-aek2a*******
LastRecoverPoint	integer	A hora em que a última replicação assíncrona foi concluída para o grupo consistente de pares de replicação. Este parâmetro é um carimbo de data/hora UNIX. Unidade: segundos.	1637835114
ReplicaGroupId	string	O ID do grupo consistente de pares de replicação.	pg-myreplica****
RPO	integer	O objetivo de ponto de recuperação (RPO) do grupo consistente de pares de replicação. Unidade: segundos.	180
SourceRegionId	string	O ID da região do site de produção.	cn-beijing
DestinationRegionId	string	O ID da região do site de recuperação de desastres.	cn-shanghai
Bandwidth	integer	A largura de banda. Unidade: Kbit/s. Este parâmetro ainda não está disponível. O valor retornado é predefinido pelo sistema.	0
PrimaryZone	string	A zona de origem inicial do grupo de replicação.	cn-beijing-h
SourceZoneId	string	O ID da zona do site de produção.	cn-beijing-f
Tags	array<object>	As tags do grupo de replicação.
	object
TagKey	string	The key of the tag of the replication group.	testKey
TagValue	string	The value of the tag of the replication group.	testValue
Status	string	O status do grupo consistente de pares de replicação. Valores válidos: invalid: O grupo consistente de pares de replicação é inválido. Este status indica que um par de replicação no grupo está anormal. creating: O grupo consistente de pares de replicação está sendo criado. created: O grupo consistente de pares de replicação foi criado. create_failed: Falha ao criar o grupo consistente de pares de replicação. manual_syncing: O grupo consistente de pares de replicação está realizando uma sincronização única. O grupo também está neste estado durante a primeira sincronização única. syncing: O grupo consistente de pares de replicação está sincronizando dados. O grupo está neste estado quando os dados são replicados de forma assíncrona do disco primário para o disco secundário em um momento subsequente. normal: Normal. Quando a replicação de dados é concluída no ciclo de replicação assíncrona atual, o grupo está neste estado. stopping: O grupo consistente de pares de replicação está sendo parado. stopped: O grupo consistente de pares de replicação está parado. stop_failed: Falha ao parar o grupo consistente de pares de replicação. failovering: Um failover está sendo realizado. failovered: O failover foi concluído. failover_failed: O failover falhou. reprotecting: Uma replicação reversa está sendo realizada. reprotect_failed: A replicação reversa falhou. deleting: O grupo consistente de pares de replicação está sendo excluído. delete_failed: Falha ao excluir o grupo consistente de pares de replicação. deleted: O grupo consistente de pares de replicação foi excluído.	created
PairNumber	integer	O número de pares de replicação no grupo consistente de pares de replicação.	2
PrimaryRegion	string	A região de origem inicial do grupo de replicação.	cn-beijing
PairIds	array	A lista de IDs de pares de replicação no grupo consistente de pares de replicação.
	string	Os IDs dos pares de replicação no grupo consistente de pares de replicação.	pair-cn-dsa**,pair-cn-asd**
EnableRtc	boolean	Especifica se o controle de tempo de replicação (RTC) deve ser ativado. Valores válidos: false: Desativa o RTC. true: Ativa o RTC. Nota Se você definir este parâmetro como true, o RTC será ativado para o grupo consistente de pares de replicação e todos os pares de replicação assíncrona que forem adicionados ao grupo.	true
DestinationZoneId	string	O ID da zona do site de recuperação de desastres.	cn-shanghai-e
StandbyRegion	string	A região de destino inicial do grupo de replicação.	cn-shanghai
PageNumber	integer	O número da página.	1
PageSize	integer	O número de entradas por página.	10
TotalCount	integer	O número total de entradas retornadas.	60

Exemplos

Resposta de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
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 Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.