Enables the reverse replication feature for replication pairs in a replication pair-consistent group. After reverse replication is enabled, data stored on the original secondary disks is replicated back to the original primary disks. When a reverse replication is being performed, the primary and secondary sites of the replication pair-consistent group remain unchanged, but data is replicated from the secondary site to the primary site.

Description

  • The replication pair-consistent group feature is supported in the China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Heyuan), China (Chengdu), China (Hong Kong), Singapore (Singapore), US (Silicon Valley), and US (Virginia) regions.
  • The replication pair-consistent group for which you want to enable reverse replication must be in the Failover Completed (failovered) state. You can call the FailoverDiskReplicaPair operation to enable failover.
  • Before a reverse replication is performed, the primary disks must be detached from its associated Elastic Compute Service (ECS) instance and is in the Unattached state. You can call the DetachDisk operation to detach disks.
  • After you enable reverse replication, you must call the StartDiskReplicaPair operation again to enable the async replication feature before data can be replicated from the original secondary disks to the original primary disks.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ReprotectDiskReplicaGroup

The operation that you want to perform. Set the value to ReprotectDiskReplicaGroup.

RegionId String Yes cn-shanghai

The region ID of the secondary site of the replication pair-consistent group.

ReplicaGroupId String Yes pg-myreplica****

The ID of the replication pair-consistent group. You can call the DescribeDiskReplicaGroups operation to query the IDs of replication pair-consistent groups.

ClientToken String No 123e4567-e89b-12d3-a456-42665544****

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that the value is unique among different requests. The ClientToken value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

Response parameters

Parameter Type Example Description
RequestId String C123F94F-4E38-19AE-942A-A8D6F44F****

The ID of the request.

Examples

Sample requests

http(s)://ecs.aliyuncs.com/?Action=ReprotectDiskReplicaGroup
&RegionId=cn-shanghai
&ReplicaGroupId=pg-myreplica****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&SourceRegionId=cn-beijing
&SourceZoneId=cn-beijing-f
&<Common request parameters>

Sample success responses

XML format 

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

<ReprotectDiskReplicaGroupResponse>
    <RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
</ReprotectDiskReplicaGroupResponse>

JSON format 

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

{
  "RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F****"
}

Error codes

HTTP status code Error code Error message Description
404 InvalidRegionId.NotFound The specified RegionId does not exist. The error message returned because the specified region ID does not exist.
404 InvalidZoneId.NotFound The specified ZoneId does not exist. The error message returned because the specified zone ID does not exist.
404 NoSuchResource The specified resource does not exist. The error message returned because the specified resource does not exist.
504 RequestTimeout The request is timeout, please try again later. The error message returned because the request timed out. Try again later.
500 InternalError The request processing has failed due to some unknown error, exception or failure. The error message returned because an internal error has occurred.
403 InvalidPayMethod The specified pay method is not valid. The error message returned because the billing method is not supported. Check whether the chargeType parameter is valid.
403 Forbidden User is not authorized to operate. The error message returned because you are not authorized to manage the resource. Check the permissions of your account or contact your Alibaba Cloud account administrator.
403 Forbidden.Action User is not authorized to operate this action. The error message returned because you are not authorized to perform this operation. Check the permissions of your account or contact your Alibaba Cloud account administrator.
403 NoPermission.SLR The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS. The error message returned because you are not authorized to create service-linked roles.
403 LastTokenProcessing The last token request is processing. The error message returned because the ClientToken value is used in another request that is being processed. Try again later.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. The error message returned because your account balance is insufficient.
403 InvalidDiskCategory.NotSupported The specified disk category is not supported. The error message returned because the specified disk category is not supported by this operation. Check the specified value and refer to related API documentation.
403 OperationDenied The operation is not allowed. The error message returned because the operation is not supported.
403 OperationDenied.QuotaExceed The operation is not allowed due to quota exceed. The error message returned because the operation is not supported while the quota is exceeded.
403 NotOnSale.Region The specified region is not on sale. The error message returned because requested resources are unavailable for purchase or out of stock in the region.
403 NotOnSale.Zone The specified zone is not on sale. The error message returned because requested resources are unavailable for purchase or out of stock in the zone.
403 OperationDenied.PairInAnotherGroup The operation is not allowed because pair is already in another group. The error message returned because the operation is not supported while the replication pair is already added to another replication pair-consistent group.
403 OperationDenied.PairNotInGroup The operation is not allowed because pair is not in any group. The error message returned because the operation is not supported while the specified replication pair is not added to replication pair-consistent groups.
403 OperationDenied.NoPairInGroup The operation is not allowed because no pair in the group. The error message returned because the operation is not supported while no replication pairs are present in the specified replication pair-consistent group.
403 OperationDenied.PairsExceedInGroup The operation is not allowed due to too much pair in the group. The error message returned because the operation is not supported while the maximum number of replication pairs in the replication pair-consistent group has been reached.
403 OperationDenied.ManualSyncLimit One shot start manual syncing too frequently, please try again later. The error message returned because the cooldown time of manual synchronization is invalid.
403 OperationDenied.GroupTotalDiskCapacityLimit Operation failed because of total disk capacity in group over limit. The error message returned because the total capacity of disks in the replication pair-consistent group exceeds the maximum allowed value.

For a list of error codes, visit the API Error Center.