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

Observações de uso

A replicação assíncrona protege dados entre regiões por meio da capacidade de replicação de dados do Elastic Block Storage (EBS). Utilize esse recurso para replicar dados de um disco em uma região para um disco em outra região de forma assíncrona, com fins de recuperação de desastres. Essa funcionalidade permite implementar a recuperação de desastres para negócios críticos, proteger dados em seus bancos de dados e melhorar a continuidade dos negócios. A cobrança pela largura de banda utilizada pelo recurso de replicação assíncrona ocorre mediante assinatura.

Atualmente, o recurso de replicação assíncrona replica dados apenas entre SSDs aprimorados (ESSDs). A funcionalidade dos discos em pares de replicação é limitada.

Observe os seguintes itens:

Certifique-se de que o disco de origem (disco primário) e o disco de destino (disco secundário) já foram criados. Chame a operação CreateDisk para criar discos.
O disco secundário não pode residir na mesma região do disco primário. Para obter informações sobre as regiões que oferecem suporte à replicação assíncrona, consulte Visão geral.
Após chamar esta operação para criar um par de replicação, chame a operação StartDiskReplicaPair para ativar a replicação assíncrona e replicar periodicamente os dados do disco primário para o disco secundário entre regiões.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateDiskReplicaPair	A operação a ser executada. Defina o valor como CreateDiskReplicaPair.
RegionId	String	Sim	cn-shanghai	O ID da região onde o par de replicação será criado.
SourceZoneId	String	Sim	cn-beijing-f	O ID da zona do disco primário.
DiskId	String	Sim	d-iq80sgp4d0xbk24q****	O ID do disco primário.
DestinationRegionId	String	Sim	cn-shanghai	O ID da região do disco secundário. Chame a operação DescribeRegions para consultar a lista mais recente de regiões com suporte à replicação assíncrona.
DestinationDiskId	String	Sim	d-sa1f82p58p1tdw9g****	O ID do disco secundário.
DestinationZoneId	String	Sim	cn-shanghai-e	O ID da zona do disco secundário.
PairName	String	Não	TestReplicaPair	O nome do par de replicação. O nome deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com `http://` ou `https://`. Pode conter letras, dígitos, dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).
Description	String	Não	This is description.	A descrição do par de replicação. A descrição deve ter de 2 a 256 caracteres e não pode começar com `http://` ou `https://`.
ChargeType	String	Não	PREPAY	O método de faturamento do par de replicação. Valores válidos: PREPAY: assinatura POSTPAY: pagamento conforme o uso Valor padrão: POSTPAY.
Period	Long	Não	1	A duração da assinatura do par de replicação. Quando `ChargeType` for definido como PREPAY, este parâmetro é obrigatório. Valores válidos: 1, 2, 3, 6, 12, 24, 36 e 60. A unidade de duração da assinatura é especificada por `PeriodUnit`.
PeriodUnit	String	Não	Month	A unidade de duração da assinatura do par de replicação. Defina o valor como Month. Valor válido: Month
ClientToken	String	Não	123e4567-e89b-12d3-a456-42665544****	O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas certifique-se de que ele seja exclusivo entre solicitações diferentes. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.
Bandwidth	Long	Não	10240	A largura de banda para replicar dados de forma assíncrona do disco primário para o disco secundário. Unidade: Kbit/s. Valores válidos: 10240 20480 51200 102400 Valor padrão: 10240. Se o parâmetro ChargeType for definido como POSTPAY, o parâmetro Bandwidth será automaticamente definido como 0 e não poderá ser modificado. O valor 0 indica que a largura de banda é alocada dinamicamente com base no volume de dados replicados de forma assíncrona do disco primário para o disco secundário.
RPO	Long	Não	900	O objetivo de ponto de recuperação (RPO) do par de replicação. Unidade: segundos. Valor válido: 900.
ResourceGroupId	String	Não	rg-acfmvs****	O ID do grupo de recursos ao qual atribuir o par de replicação.
Tag.N.Key	String	Não	TestKey	A chave da tag N a ser adicionada ao par de replicação.
Tag.N.Value	String	Não	TestValue	O valor da tag N a ser adicionada ao par de replicação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	C123F94F-4E38-19AE-942A-A8D6F44F****	O ID da solicitação.
ReplicaPairId	String	pair-cn-dsa****	O ID do par de replicação.
OrderId	String	123456****	O ID do pedido.

Exemplos

Exemplos de solicitações

http(s)://ebs.cn-beijing.aliyuncs.com/?Action=CreateDiskReplicaPair
&RegionId=cn-shanghai
&SourceZoneId=cn-beijing-f
&DiskId=d-iq80sgp4d0xbk24q****
&DestinationRegionId=cn-shanghai
&DestinationDiskId=d-sa1f82p58p1tdw9g****
&DestinationZoneId=cn-shanghai-e
&PairName=TestReplicaPair
&Description=This is description.
&ChargeType=PREPAY
&Period=1
&PeriodUnit=Month
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Bandwidth=10240
&RPO=900
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CreateDiskReplicaPairResponse>
    <RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
    <ReplicaPairId>pair-cn-dsa****</ReplicaPairId>
    <OrderId>123456****</OrderId>
</CreateDiskReplicaPairResponse>

Formato JSON

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

{
  "RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F****",
  "ReplicaPairId" : "pair-cn-dsa****",
  "OrderId" : "123456****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	A solicitação e uma solicitação anterior contêm o mesmo token de cliente, mas parâmetros diferentes.
403	OperationDenied	The operation is not allowed.	Você não pode executar esta operação.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	Esta operação não pode ser executada no recurso no estado atual.
403	OperationDenied.QuotaExceed	The operation is not allowed due to quota exceed.	A cota foi excedida.
403	LastTokenProcessing	The last token request is processing.	O valor de clientToken está sendo usado em outra solicitação em processamento. Tente novamente mais tarde.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Sua conta não tem saldo suficiente.
403	Forbidden	User is not authorized to operate.	Você não tem permissões para executar esta operação no recurso. Verifique as permissões da sua conta ou entre em contato com o administrador da conta de locatário do Apsara Stack.
403	Forbidden.Action	User is not authorized to operate this action.	Você não tem acesso a esta operação. Verifique as permissões da sua conta ou entre em contato com o administrador da conta Alibaba Cloud.
404	NoSuchResource	The specified resource does not exist.	O recurso especificado não foi 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 solicitação expirou. Tente novamente mais tarde.

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