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

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

Descrição da operação

Descrição

Para obter informações sobre as regiões que suportam replicação assíncrona, consulte Visão geral da replicação assíncrona para discos.
Se o disco primário ou secundário de um par de replicação assíncrona estiver na região especificada, a consulta retornará informações sobre esse par de replicação.
Para realizar uma consulta paginada, use os parâmetros MaxResults e NextToken. Para a primeira página, defina MaxResults para limitar o número de entradas retornadas. O valor NextToken na resposta é o token para a próxima página. Para as páginas subsequentes, defina NextToken com o valor da resposta anterior e defina MaxResults para limitar o número de entradas.

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

get

*DiskReplicaPair

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

*DiskReplicaPair

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região onde reside o disco primário ou secundário do par de replicação. Chame a operação DescribeRegions para consultar as regiões que suportam replicação assíncrona.	cn-beijing
MaxResults	integer	Não	O número máximo de entradas a serem retornadas em cada página. Use este parâmetro com NextToken. Valores válidos: 1 a 500. Valor padrão: 10.	1
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 valor TotalCount na resposta será inválido.	AAAAAdDWBF2****
PairIds	string	Não	Os IDs dos pares de replicação. Especifique um ou mais IDs de pares de replicação. Os IDs devem estar no formato `pair-cn-dsa**,pair-cn-asd**`. Se você deixar este parâmetro vazio, todos os pares de replicação na região atual serão consultados. Você pode especificar até 100 IDs de pares de replicação.	pair-cn-dsa****
Site	string	Não	O site de onde consultar dados. Consulte dados do site de produção ou do site de recuperação de desastres. Valores válidos: production: o site de produção. backup: o site de recuperação de desastres. Valor padrão: production.	production
ReplicaGroupId	string	Não	O ID do grupo consistente de pares de replicação. Especifique o ID de um grupo consistente de pares de replicação para consultar os pares de replicação no grupo. O ID deve estar no formato `pg-**`. Se você deixar este parâmetro vazio, todos os pares de replicação na região atual serão consultados. Nota** Se você definir este parâmetro como `-`, os pares de replicação que não estão em nenhum grupo consistente de pares de replicação serão retornados.	pg-****
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 par de replicação pertence.	rg-acfmvs******
Name	string	Não	O nome do par de replicação. Há suporte para correspondência aproximada.	name***
Tag	array<object>	Não	As tags. Você pode especificar até 20 tags.
	object	Não	A tag.
Value	string	Não	O valor da tag.	TestValue
Key	string	Não	A chave da tag.	TestKey

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 desta chamada.	AAAAAdDWBF2****
ReplicaPairs	array<object>	Os pares de replicação.
	array<object>
Site	string	O tipo de site do par de replicação ou 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
DestinationDiskId	string	O ID do disco secundário.	d-asdfjl2342kj2l3k4****
Description	string	A descrição do par de replicação.	This is description.
StandbyZone	string	A zona de destino inicial do par de replicação.	cn-shanghai-b
ResourceGroupId	string	O ID do grupo de recursos ao qual o par de replicação pertence.	rg-acfmvs*****
DestinationRegion	string	A região do disco secundário.	cn-shanghai
ReplicaPairId	string	O ID do par de replicação.	pair-cn-dsa****
LastRecoverPoint	integer	A hora em que a última replicação assíncrona foi concluída. Este valor é um carimbo de data/hora UNIX. Unidade: segundos.	1649751977
ReplicaGroupId	string	O ID do grupo consistente de pares de replicação ao qual o par de replicação pertence.	pg-xxxx****
SourceDiskId	string	O ID do disco primário.	d-bp131n0q38u3a4zi****
RPO	integer	O objetivo de ponto de recuperação (RPO) do par de replicação. Unidade: segundos.	900
PairName	string	O nome do par de replicação.	TestReplicaPair
Bandwidth	integer	A largura de banda usada para replicação assíncrona. Unidade: Kbit/s.	10240
ExpiredTime	integer	A hora de expiração do par de replicação. Este valor é um carimbo de data/hora UNIX. Unidade: segundos.	1649750977
PrimaryZone	string	A zona de origem inicial do par de replicação.	cn-beijing-a
SourceZoneId	string	A zona do disco primário.	cn-beijing-a
Tags	array<object>	As tags do par de replicação.
	object	A tag.
TagKey	string	The key of the tag.	testKey
TagValue	string	The value of the tag.	testValue
Status	string	O status do par de replicação. Valores válidos: invalid: O par de replicação é inválido. Este status indica que o par de replicação não está funcionando corretamente. creating: O par de replicação está sendo criado. created: O par de replicação foi criado. create_failed: Falha ao criar o par de replicação. initial_syncing: O par de replicação está no estado de sincronização inicial. Depois que um par de replicação é criado e iniciado, ele entra neste estado durante a primeira replicação assíncrona de dados do disco primário para o disco secundário. manual_syncing: O par de replicação está sendo sincronizado manualmente. Após a conclusão da sincronização manual, o par de replicação retorna ao estado parado. Se for a primeira sincronização única, o status também será manual_syncing. syncing: O par de replicação está sincronizando dados. O par de replicação está neste estado quando os dados são replicados de forma assíncrona do disco primário para o disco secundário pela segunda vez ou subsequentemente. normal: O par de replicação está no estado normal. O par de replicação entra neste estado quando a replicação de dados é concluída no ciclo de replicação atual. stopping: O par de replicação está sendo parado. stopped: O par de replicação está parado. stop_failed: Falha ao parar o par de replicação. failovering: Um failover está em andamento. failovered: O failover foi concluído. failover_failed: O failover falhou. reprotecting: Uma replicação reversa está em andamento. reprotect_failed: A replicação reversa falhou. deleting: O par de replicação está sendo excluído. delete_failed: Falha ao excluir o par de replicação. deleted: O par de replicação foi excluído.	created
PrimaryRegion	string	A região de origem inicial do par de replicação.	cn-beijing
CreateTime	integer	A hora de criação. Este valor é um carimbo de data/hora UNIX. Unidade: segundos.	1649750977
SourceRegion	string	A região do disco primário.	cn-beijing
StatusMessage	string	A mensagem de status do par de replicação. Este parâmetro é retornado quando o Status é `invalid` ou `create_failed`. Valores válidos: PrePayOrderExpired: O par de replicação por assinatura expirou. PostPayOrderCeaseService: O serviço do par de replicação pós-pago foi suspenso, geralmente devido a um pagamento em atraso. DeviceRemoved: O disco primário ou secundário foi excluído. DeviceKeyChanged: O mapeamento `DeviceKey` do disco primário ou secundário foi alterado. DeviceSizeChanged: O `DeviceSize` do disco primário ou secundário foi alterado. OperationDenied.QuotaExceed: O número de pares de replicação criados excede a cota.	PrePayOrderExpired
EnableRtc	boolean	Especifica se o controle em tempo real (RTC) está ativado. Valores válidos: false: Desativado. true: Ativado. Nota Se o par de replicação estiver em um grupo consistente de pares de replicação, o valor deste parâmetro será o mesmo do grupo.
ChargeType	string	O método de cobrança do par de replicação. Valores válidos: PREPAY: assinatura. POSTPAY: pós-pago.	PREPAY
DestinationZoneId	string	A zona do disco secundário.	cn-shanghai-b
ReplicaGroupName	string	O nome do grupo consistente de pares de replicação ao qual o par de replicação pertence.	pg-name****
StandbyRegion	string	A região de destino inicial do par 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.	60

Exemplos

Resposta de sucesso

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