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

Notas de uso

Para consultar com paginação, especifique MaxResults e NextToken.

Em consultas paginadas, ao chamar a operação DescribeDiskReplicaGroups para obter a primeira página de resultados, defina MaxResults como o número máximo de entradas a retornar. O valor retornado de NextToken é um token de paginação utilizável na próxima chamada para recuperar uma nova página. Para obter páginas subsequentes, defina NextToken com o valor de NextToken retornado na chamada anterior e configure MaxResults para limitar as entradas desta requisição.

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 requisição

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeDiskReplicaGroups	Operação a ser executada. Defina o valor como DescribeDiskReplicaGroups.
RegionId	String	Yes	cn-beijing	ID da região do grupo consistente de pares de replicação.
MaxResults	Long	No	10	Número máximo de entradas por página. Valores válidos: 1 a 500. Valor padrão: 10.
NextToken	String	No	AAAAAdDWBF2****	Token de paginação usado na próxima requisição para recuperar uma nova página de resultados. Não é necessário especificar este parâmetro na primeira requisição. Nas requisições seguintes, use o token obtido anteriormente como valor de NextToken. Se NextToken for especificado, os parâmetros PageSize e PageNumber serão ignorados e o parâmetro de resposta TotalCount ficará inválido.
GroupIds	String	No	AAAAAdDWBF2****	IDs dos grupos consistentes de pares de replicação. Você pode especificar até 100 IDs, separados por vírgulas (,). Se deixado vazio, a consulta retornará todos os grupos consistentes de pares de replicação da região especificada.
Site	String	No	production	Tipo de site de onde as informações dos grupos consistentes de pares de replicação são recuperadas. Aplica-se a cenários de replicação de dados entre zonas. Se omitido, o sistema retorna informações como o status dos grupos no site primário. Se especificado, o sistema retorna informações referentes ao site indicado. Valores válidos: production: site primário backup: site secundário
PageNumber	Integer	No	5	Número da página.
PageSize	Integer	No	10	Quantidade de entradas por página. Valores válidos: 1 a 100.
ResourceGroupId	String	No	rg-aekz*****	ID do grupo de recursos ao qual o grupo consistente de pares de replicação pertence.
Tag.N.Key	String	No	tag-key	Chave da tag N do grupo consistente de pares de replicação.
Tag.N.Value	String	No	tag-value	Valor da tag N do grupo consistente de pares de replicação.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****	ID da requisição.
NextToken	String	AAAAAdDWBF2****	Token de paginação. Use-o na próxima requisição para recuperar uma nova página de resultados.
ReplicaGroups	Array of ReplicaGroup		Informações sobre os grupos consistentes de pares de replicação.
ReplicaGroupId	String	pg-myreplica****	ID do grupo consistente de pares de replicação.
SourceRegionId	String	cn-beijing	ID da região do site primário.
SourceZoneId	String	cn-beijing-f	ID da zona do site primário.
DestinationRegionId	String	cn-shanghai	ID da região do site secundário.
DestinationZoneId	String	cn-shanghai-e	ID da zona do site secundário.
GroupName	String	myreplicagrouptest	Nome do grupo consistente de pares de replicação.
Description	String	This is description.	Descrição do grupo consistente de pares de replicação.
Status	String	created	Estado do grupo consistente de pares de replicação. Valores válidos: invalid: O grupo é inválido, indicando a presença de pares de replicação anormais. creating: Criação do grupo em andamento. created: Grupo criado com sucesso. create_failed: Falha na criação do grupo. manual_syncing: Sincronização manual de dados entre os discos do grupo em progresso. Este estado ocorre durante a primeira sincronização manual. syncing: Sincronização de dados entre os discos do grupo em andamento. Este estado indica que a replicação assíncrona dos discos primários para os secundários não é a primeira. normal: Funcionamento esperado do grupo. O grupo entra neste estado após o sistema concluir a replicação de dados dos discos primários para os secundários no ciclo atual. stopping: Parada do grupo em andamento. stopped: Grupo parado. stop_failed: Impossível parar o grupo. failovering: Execução de failover em andamento. failovered: Failover executado com sucesso. failover_failed: Falha ao executar o failover. reprotecting: Replicação reversa em execução. reprotect_failed: Impossível realizar a replicação reversa. deleting: Exclusão do grupo em andamento. delete_failed: Falha ao excluir o grupo. deleted: Grupo excluído.
RPO	Long	180	Objetivo de ponto de recuperação (RPO) do grupo consistente de pares de replicação. Unidade: segundos.
LastRecoverPoint	Long	1637835114	Momento da última replicação de dados dos discos primários para os secundários no grupo consistente de pares de replicação. O valor é um timestamp. Unidade: segundos.
Site	String	production	Tipo de site de onde se obtêm as informações do par de replicação e do grupo consistente de pares de replicação. Valores válidos: production: site primário backup: site secundário
PairIds	Array of String	pair-cn-dsa**,pair-cn-asd**	IDs dos pares de replicação pertencentes ao grupo consistente de pares de replicação.
PairNumber	Long	2	Quantidade de pares de replicação pertencentes ao grupo consistente de pares de replicação.
PrimaryRegion	String	cn-beijing	Região de origem inicial (região primária) do grupo consistente de pares de replicação.
StandbyRegion	String	cn-shanghai	Região de destino inicial (região secundária) do grupo consistente de pares de replicação.
PrimaryZone	String	cn-beijing-h	Zona de origem inicial (zona primária) do grupo consistente de pares de replicação.
StandbyZone	String	cn-shanghai-e	Zona de destino inicial (zona secundária) do grupo consistente de pares de replicação.
Bandwidth	Long	0	Valor da largura de banda. Unidade: Mbit/s. Este parâmetro não é público e possui um valor predefinido pelo sistema.
ResourceGroupId	String	rg-aek2a*******	ID do grupo de recursos ao qual o grupo consistente de pares de replicação pertence.
Tags	Array of Tag		Tags do grupo consistente de pares de replicação.
TagKey	String	testKey	Chave da tag do grupo consistente de pares de replicação.
TagValue	String	testValue	Valor da tag do grupo consistente de pares de replicação.
PageNumber	Integer	1	Número da página.
PageSize	Integer	10	Quantidade de entradas por página.
TotalCount	Long	60	Número total de entradas retornadas.

Exemplos

Exemplos de requisições

http(s)://ecs.aliyuncs.com/?Action=DescribeDiskReplicaGroups
&RegionId=cn-beijing
&MaxResults=10
&NextToken=AAAAAdDWBF2****
&GroupIds=AAAAAdDWBF2****
&Site=production
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDiskReplicaGroupsResponse>
    <RequestId>AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****</RequestId>
    <NextToken>AAAAAdDWBF2****</NextToken>
    <ReplicaGroups>
        <ReplicaGroupId>pg-myreplica****</ReplicaGroupId>
        <SourceRegionId>cn-beijing</SourceRegionId>
        <SourceZoneId>cn-beijing-f</SourceZoneId>
        <DestinationRegionId>cn-shanghai</DestinationRegionId>
        <DestinationZoneId>cn-shanghai-e</DestinationZoneId>
        <GroupName>myreplicagrouptest</GroupName>
        <Description>This is description.</Description>
        <Status>created</Status>
        <RPO>180</RPO>
        <LastRecoverPoint>1637835114</LastRecoverPoint>
        <Site>production</Site>
        <PairIds>pair-cn-dsa****,pair-cn-asd****</PairIds>
        <PairNumber>2</PairNumber>
    </ReplicaGroups>
</DescribeDiskReplicaGroupsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
  "NextToken" : "AAAAAdDWBF2****",
  "ReplicaGroups" : [ {
    "ReplicaGroupId" : "pg-myreplica****",
    "SourceRegionId" : "cn-beijing",
    "SourceZoneId" : "cn-beijing-f",
    "DestinationRegionId" : "cn-shanghai",
    "DestinationZoneId" : "cn-shanghai-e",
    "GroupName" : "myreplicagrouptest",
    "Description" : "This is description.",
    "Status" : "created",
    "RPO" : 180,
    "LastRecoverPoint" : 1637835114,
    "Site" : "production",
    "PairIds" : [ "pair-cn-dsa****,pair-cn-asd****" ],
    "PairNumber" : 2
  } ]
}

Códigos de erro

HTTP status code	Error code	Error message	Description
403	OperationDenied	The operation is not allowed.	Esta operação não pode ser executada.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	Impossível executar esta operação no grupo consistente de pares de replicação no estado atual.
403	Forbidden	User is not authorized to operate.	Você não tem permissões para gerenciar o recurso. Verifique as permissões da sua conta ou entre em contato com o administrador da sua 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 sua conta ou entre em contato com o administrador da sua 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.	Ocorreu um erro interno.
504	RequestTimeout	The request is timeout, please try again later.	A requisição expirou. Tente novamente mais tarde.

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