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

Observações de uso

Para obter informações sobre as regiões onde a replicação assíncrona está disponível, consulte Visão geral.
Ao chamar esta operação para uma região específica, se o disco primário (disco de origem) ou o disco secundário (disco de destino) de um par de replicação estiver localizado nessa região, a resposta exibirá as informações do par.
Para consultas paginadas, configure os parâmetros NextToken e MaxResults. Na primeira chamada à operação DescribeDiskReplicaPairs, defina MaxResults para limitar o número máximo de entradas retornadas. O valor retornado em NextToken é um token de paginação; use-o na próxima chamada para obter uma nova página de resultados. Nas chamadas subsequentes, defina NextToken com o valor retornado anteriormente e especifique MaxResults para indicar o limite de entradas da página atual.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação, pois ela gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeDiskReplicaPairs	Operação a ser executada. Defina o valor como DescribeDiskReplicaPairs.
RegionId	String	Sim	cn-beijing	ID da região do disco primário ou secundário no par de replicação. Chame a operação DescribeRegions para consultar a lista mais recente de regiões com suporte a replicação assíncrona.
MaxResults	Long	Não	1	Número máximo de entradas a retornar. Use este parâmetro em conjunto com NextToken. Valores válidos: 1 a 500. Valor padrão: 10.
NextToken	String	Não	AAAAAdDWBF2****	Token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Não especifique este parâmetro na primeira solicitação. Nas solicitações seguintes, insira o token obtido na consulta anterior. Ao especificar NextToken, os parâmetros PageSize e PageNumber perdem o efeito e o parâmetro de resposta TotalCount torna-se inválido.
PairIds	String	Não	pair-cn-dsa****	IDs dos pares de replicação. Especifique um ou mais IDs separados por vírgulas (,). Exemplo: `pair-cn-dsa,pair-cn-asd`. Se deixado vazio, todos os pares de replicação na região especificada serão consultados. Limite: até 100 IDs.
Site	String	Não	production	Tipo de site de onde recuperar as informações dos pares de replicação. Valores válidos: production: site primário backup: site secundário Valor padrão: production.
ReplicaGroupId	String	Não	pg-****	ID do grupo consistente de pares de replicação. Especifique este ID para consultar apenas os pares pertencentes ao grupo. Exemplo: `pg-**`. Se deixado vazio, todos os pares de replicação na região especificada serão consultados. Nota** Se definido como `-`, a consulta retornará apenas os pares de replicação que não pertencem a nenhum grupo consistente.
PageNumber	Integer	Não	5	Número da página.
PageSize	Integer	Não	10	Número de entradas por página. Valores válidos: 1 a 100.
ResourceGroupId	String	Não	rg-acfmvs******	ID do grupo de recursos ao qual atribuir o par de replicação.
Tag.N.Key	String	Não	TestKey	Chave da tag N do par de replicação.
Tag.N.Value	String	Não	TestValue	Valor da tag N do par de replicação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****	ID da solicitação.
NextToken	String	AAAAAdDWBF2****	Token de paginação. Use-o na próxima solicitação para recuperar uma nova página de resultados. Se vazio, não há mais páginas.
ReplicaPairs	Array of ReplicaPair		Detalhes dos pares de replicação.
ReplicaPairId	String	pair-cn-dsa****	ID do par de replicação.
SourceRegion	String	cn-beijing	ID da região do disco primário.
SourceZoneId	String	cn-beijing-a	ID da zona do disco primário.
SourceDiskId	String	d-bp131n0q38u3a4zi****	ID do disco primário.
DestinationRegion	String	cn-shanghai	ID da região do disco secundário.
DestinationZoneId	String	cn-shanghai-b	ID da zona do disco secundário.
DestinationDiskId	String	d-asdfjl2342kj2l3k4****	ID do disco secundário.
PairName	String	TestReplicaPair	Nome do par de replicação.
Description	String	This is description.	Descrição do par de replicação.
Status	String	created	Status do par de replicação. Valores válidos: invalid: par de replicação inválido. Estado assumido quando ocorre uma anomalia. creating: criação do par de replicação em andamento. created: par de replicação criado com sucesso. create_failed: falha na criação do par de replicação. initial_syncing: primeira sincronização de dados do disco primário para o secundário. Estado inicial após a criação e ativação do par. manual_syncing: sincronização manual de dados do disco primário para o secundário em andamento. Após a conclusão, o par retorna ao estado Stopped. syncing: sincronização de dados do disco primário para o secundário em andamento. Estado ativo durante replicações assíncronas subsequentes à primeira. normal: funcionamento conforme esperado. Estado atingido ao concluir a replicação de dados dentro do ciclo atual. stopping: parada do par de replicação em andamento. stopped: par de replicação parado. stop_failed: falha ao parar o par de replicação. failovering: failover em andamento. failovered: failover concluído. failover_failed: falha na execução do failover. reprotecting: replicação reversa em andamento. reprotect_failed: falha na execução da replicação reversa. deleting: exclusão do par de replicação em andamento. delete_failed: falha na exclusão do par de replicação. deleted: par de replicação excluído.
RPO	Long	900	Objetivo de ponto de recuperação (RPO) do par de replicação. Unidade: segundos. 86.400 segundos equivalem a 24 horas.
Bandwidth	Long	10240	Largura de banda usada para replicar dados assincronicamente do disco primário para o secundário. Unidade: Kbit/s.
StatusMessage	String	PrePayOrderExpired	Mensagem descritiva do estado do par de replicação. Presente apenas quando `Status` for invalid ou `create_failed`. Valores válidos: PrePayOrderExpired: o par de replicação expirou. PostPayOrderCeaseService: par de replicação com pagamento conforme o uso interrompido por falta de pagamento. DeviceRemoved: disco primário ou secundário excluído. DeviceKeyChanged: alteração no mapeamento `DeviceKey` do disco primário ou secundário. DeviceSizeChanged: alteração no valor de `DeviceSize` do disco primário ou secundário. OperationDenied.QuotaExceed: limite máximo de pares de replicação atingido.
LastRecoverPoint	Long	1649751977	Timestamp da última replicação de dados do disco primário para o secundário. Unidade: segundos. 86.400 segundos equivalem a 24 horas.
ReplicaGroupId	String	pg-xxxx****	ID do grupo consistente de pares de replicação ao qual o par pertence.
CreateTime	Long	1649750977	Timestamp de criação do par de replicação. Unidade: segundos. 86.400 segundos equivalem a 24 horas.
ReplicaGroupName	String	pg-name****	Nome do grupo consistente de pares de replicação ao qual o par pertence.
Site	String	production	Tipo de site de onde as informações sobre os pares de replicação e o grupo consistente foram obtidas. Valores válidos: production: site primário backup: site secundário
PrimaryRegion	String	cn-beijing	Região de origem inicial (região primária) do par de replicação.
StandbyRegion	String	cn-shanghai	Região de destino inicial (região secundária) do par de replicação.
PrimaryZone	String	cn-beijing-a	Zona de origem inicial (zona primária) do par de replicação.
StandbyZone	String	cn-shanghai-b	Zona de destino inicial (zona secundária) do par de replicação.
ChargeType	String	PREPAY	Método de faturamento do par de replicação. Valores válidos: PREPAY: assinatura POSTPAY: pagamento conforme o uso
ExpiredTime	Long	1649750977	Timestamp de expiração do par de replicação. Unidade: segundos. 86.400 segundos equivalem a 24 horas.
Tags	Array of Tag		Tags do par de replicação.
TagKey	String	testKey	Chave da tag do par de replicação.
TagValue	String	testValue	Valor da tag do par de replicação.
ResourceGroupId	String	rg-acfmvs*****	ID do grupo de recursos ao qual atribuir o par de replicação.
PageNumber	Integer	1	Número da página.
PageSize	Integer	10	Número de entradas por página.
TotalCount	Long	60	Número total de entradas retornadas.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	OperationDenied	The operation is not allowed.	Operação não permitida.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	Operação não permitida no estado atual do recurso.
403	Forbidden	User is not authorized to operate.	Sem permissão para executar esta operação no recurso. Verifique as permissões da conta ou contate o administrador da conta Alibaba Cloud.
403	Forbidden.Action	User is not authorized to operate this action.	Sem acesso a esta operação. Verifique as permissões da conta ou contate o administrador da conta Alibaba Cloud.
404	NoSuchResource	The specified resource does not exist.	Recurso especificado não encontrado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Erro interno desconhecido.
504	RequestTimeout	The request is timeout, please try again later.	Tempo limite da solicitação excedido. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.