调用ReprotectDiskReplicaPair启用异步复制关系的反向复制功能。启用反向复制功能后,可以将原从盘的数据复制到原主盘当中。
接口说明
- 异步复制功能支持的地域请参见云盘异步复制概述。
- 异步复制关系必须处于故障切换完成(
failovered
)状态。您可以调用FailoverDiskReplicaPair启用故障切换功能。 - 异步复制关系中,主盘必须从所属的ECS实例上卸载,即处于未挂载的状态。您可以调用DetachDisk卸载云盘。
- 启用反向复制功能后,您还需要重新调用StartDiskReplicaPair启动异步复制功能,才可以将原从盘的数据复制到原主盘当中。
- 通过设置ReverseReplicate参数为false,您可以进行取消故障切换完成(
failovered
)状态,恢复原来的复制方向。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | ReprotectDiskReplicaPair | 系统规定参数。取值:ReprotectDiskReplicaPair。 |
RegionId | String | 是 | cn-shanghai | 异步复制关系中从盘所属的地域ID。您可以调用DescribeDiskReplicaPairs查询异步复制关系中从盘的地域信息。 说明 必须在从盘所属地域下启用反向复制功能。 |
ReplicaPairId | String | 是 | pair-cn-dsa**** | 异步复制关系的ID。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性。 |
ReverseReplicate | Boolean | 否 | true | 反向复制开关:false代表恢复原方向,true代表反向复制。默认值是true。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | C123F94F-4E38-19AE-942A-A8D6F44F**** | 请求ID。 |
示例
请求示例
http(s)://ebs.cn-shanghai.aliyuncs.com/?Action=ReprotectDiskReplicaPair
&RegionId=cn-shanghai
&ReplicaPairId=pair-cn-dsa****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ReprotectDiskReplicaPairResponse>
<RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
</ReprotectDiskReplicaPairResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F****"
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
403 | OperationDenied | The operation is not allowed. | 当前操作不允许执行。 |
403 | OperationDenied.InvalidStatus | The operation is not allowed in current status. | 当前状态下该操作不允许执行。 |
403 | OperationDenied.NoPairInGroup | The operation is not allowed because no pair in the group. | 当前操作不允许执行,因为指定的一致性组中没有复制对。 |
403 | OperationDenied.PairGroupAZoneConflict | The operation is not allowed due to pair and group having different RegionId or ZoneId. | 当前操作不允许执行,因为复制对和一致性组所属的RegionId和ZoneId不一致。 |
403 | OperationDenied.PairGroupStatusConflict | The operation is not allowed due to pair and group status are not consistent. | 当前操作不允许执行,因为复制对和一致性组的状态不一致。 |
403 | OperationDenied.PairNotInGroup | The operation is not allowed because pair is not in any group. | 当前操作不允许执行,因为指定的异步复制对未加入任何一致性组中。 |
403 | OperationDenied.OperateNotAllowedForPrimary | Operation is not allowed on the primary site. | 当前操作在主端不被允许。 |
403 | OperationDenied.OperateNotAllowedForStandby | Operation is not allowed on the secondary site. | 当前操作在从端不被允许。 |
403 | Forbidden | User is not authorized to operate. | 当前用户无权限对当前资源执行任何操作。请检查您的账号权限或者咨询您的主账号管理员。 |
403 | Forbidden.Action | User is not authorized to operate this action. | 当前用户无权限执行该操作。请检查您的账号权限或者咨询您的主账号管理员。 |
404 | NoSuchResource | The specified resource does not exist. | 指定的资源不存在。 |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
504 | RequestTimeout | The request is timeout, please try again later. | 该请求超时,请稍后再重试。 |
访问错误中心查看更多错误码。