CreateDiskReplicaPair - - Centro de documentación de Alibaba Cloud

Cree un par de replicación para replicar datos de forma asíncrona entre discos.

Notas de uso

La replicación asíncrona es una función que protege los datos entre regiones mediante la capacidad de replicación de datos de Elastic Block Storage (EBS). Esta función replica de manera asíncrona los datos de un disco en una región hacia otro disco en una región distinta con fines de recuperación ante desastres. Puede utilizarla para implementar la recuperación ante desastres de sus cargas de trabajo críticas, proteger los datos de sus bases de datos y mejorar la continuidad del negocio. El ancho de banda que consume la replicación asíncrona se cobra bajo el modelo de suscripción.

Actualmente, la replicación asíncrona solo funciona entre discos SSD mejorados (ESSD). La funcionalidad de los discos que forman parte de un par de replicación es limitada.

Tenga en cuenta a continuación puntos:

Asegúrese de haber creado el disco de origen (disco principal) desde el cual se replicarán los datos y el disco de destino (disco secundario) hacia donde se replicarán. Llame a la operación CreateDisk para crear los discos.
El disco secundario no puede residir en la misma región que el disco principal. Para conocer las regiones compatibles con la replicación asíncrona, consulte Descripción general.
Después de llamar a esta operación para crear un par de replicación, llame a la operación StartDiskReplicaPair para habilitar la replicación asíncrona. De este modo, los datos se replicarán periódicamente del disco principal al disco secundario entre regiones.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer, ya que genera de forma dinámica el código de ejemplo correspondiente para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateDiskReplicaPair	Operación que desea ejecutar. Establezca el valor en CreateDiskReplicaPair.
RegionId	String	Sí	cn-shanghai	ID de la región donde se creará el par de replicación.
SourceZoneId	String	Sí	cn-beijing-f	ID de la zona del disco principal.
DiskId	String	Sí	d-iq80sgp4d0xbk24q****	ID del disco principal.
DestinationRegionId	String	Sí	cn-shanghai	ID de la región del disco secundario. Llame a la operación DescribeRegions para consultar la lista más reciente de regiones compatibles con la replicación asíncrona.
DestinationDiskId	String	Sí	d-sa1f82p58p1tdw9g****	ID del disco secundario.
DestinationZoneId	String	Sí	cn-shanghai-e	ID de la zona del disco secundario.
PairName	String	No	TestReplicaPair	Nombre del par de replicación. Debe tener entre 2 y 128 caracteres y comenzar con una letra. No puede empezar con `http://` ni con `https://`. Admite letras, dígitos, dos puntos (:), guiones bajos (_), puntos (.) y guiones (-).
Description	String	No	This is description.	Descripción del par de replicación. Debe tener entre 2 y 256 caracteres y no puede comenzar con `http://` ni con `https://`.
ChargeType	String	No	PREPAY	Método de facturación del par de replicación. Valores válidos: PREPAY: suscripción POSTPAY: pay-as-you-go Valor predeterminado: POSTPAY.
Period	Long	No	1	Duración de la suscripción del par de replicación. Este parámetro es obligatorio cuando `ChargeType` se establece en PREPAY. Valores válidos: 1, 2, 3, 6, 12, 24, 36 y 60. La unidad de tiempo se define mediante `PeriodUnit`.
PeriodUnit	String	No	Month	Unidad de tiempo de la suscripción del par de replicación. Establezca el valor en Month. Valor válido: Month
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	Token de cliente que garantiza la idempotencia de la solicitud. Puede generar este token desde el cliente, pero debe asegurarse de que sea único para cada solicitud. Solo admite caracteres ASCII y no puede superar los 64 caracteres. Para obtener más información, consulte How to ensure idempotence.
Bandwidth	Long	No	10240	Ancho de banda utilizado para replicar los datos de forma asíncrona del disco principal al disco secundario. Unidad: Kbit/s. Valores válidos: 10240 20480 51200 102400 Valor predeterminado: 10240. Cuando el parámetro ChargeType se establece en POSTPAY, el parámetro Bandwidth se configura automáticamente en 0 y no se puede modificar. El valor 0 indica que el ancho de banda se asigna de forma dinámica según el volumen de datos replicados de manera asíncrona del disco principal al disco secundario.
RPO	Long	No	900	Objetivo de punto de recuperación (RPO) del par de replicación. Unidad: segundos. Valor válido: 900.
ResourceGroupId	String	No	rg-acfmvs****	ID del resource group al que se asignará el par de replicación.
Tag.N.Key	String	No	TestKey	Clave de la etiqueta N que se agregará al par de replicación.
Tag.N.Value	String	No	TestValue	Valor de la etiqueta N que se agregará al par de replicación.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	C123F94F-4E38-19AE-942A-A8D6F44F****	ID de la solicitud.
ReplicaPairId	String	pair-cn-dsa****	ID del par de replicación.
OrderId	String	123456****	ID del pedido.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas de ejemplo exitosas

XML formato

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>

JSON formato

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

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	La solicitud actual y una anterior usan el mismo token de cliente, pero contienen parámetros distintos.
403	OperationDenied	The operation is not allowed.	No se permite ejecutar esta operación.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.	No se puede ejecutar esta operación mientras el recurso se encuentre en el estado actual.
403	OperationDenied.QuotaExceed	The operation is not allowed due to quota exceed.	Se superó la cuota permitida.
403	LastTokenProcessing	The last token request is processing.	El valor de clientToken se está utilizando en otra solicitud que aún se procesa. Inténtelo de nuevo más tarde.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Su cuenta no tiene saldo suficiente.
403	Forbidden	User is not authorized to operate.	No cuenta con los permisos necesarios para ejecutar esta operación en el recurso. Revise los permisos de su cuenta o comuníquese con el administrador de la cuenta de inquilino de Apsara Stack.
403	Forbidden.Action	User is not authorized to operate this action.	No tiene acceso a esta operación. Revise los permisos de su cuenta o comuníquese con el administrador de la cuenta de Alibaba Cloud.
404	NoSuchResource	The specified resource does not exist.	No se encontró el recurso especificado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno.
504	RequestTimeout	The request is timeout, please try again later.	La solicitud agotó el tiempo de espera. Inténtelo de nuevo más tarde.

Para consultar la lista de códigos de error, consulte Códigos de error del servicio.