调用StartDiskReplicaPair为指定的异步复制关系激活异步复制功能，以实现主盘的数据周期性地跨地域异步复制到从盘。
接口说明
- 异步复制功能支持的地域请参见云盘异步复制概述。
- 只能启动处于已创建（
created）或者已停止（stopped）状态的异步复制关系。 - 异步复制被启动后，系统会自动进行第一次异步复制操作，此时异步复制关系会处于初始同步中（
initial_syncing）的状态，该次操作会把主盘的全量数据复制到从盘。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | StartDiskReplicaPair | 系统规定参数。取值：StartDiskReplicaPair。 |
| RegionId | String | 是 | cn-beijing | 异步复制关系中主盘或从盘所属的地域ID。您可以调用DescribeDiskReplicaPairs查询存量异步复制关系的地域信息。 |
| ReplicaPairId | String | 是 | pair-cn-dsa**** | 异步复制关系的ID。 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。 |
| OneShot | Boolean | 否 | false | 是否立刻进行一次同步。取值范围：
默认值：false。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
| RequestId | String | A37597A6-BB99-19B3-85EA-4C2B91F0**** | 请求ID。 |
示例
请求示例
http(s)://ebs.cn-beijing.aliyuncs.com/?Action=StartDiskReplicaPair
&RegionId=cn-beijing
&ReplicaPairId=pair-cn-dsa****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&OneShot=false
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<StartDiskReplicaPairResponse>
<RequestId>A37597A6-BB99-19B3-85EA-4C2B91F0****</RequestId>
</StartDiskReplicaPairResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A37597A6-BB99-19B3-85EA-4C2B91F0****"
}错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 400 | OperationDenied.StandbyDeviceAttached | The secondary disk is attached. | 从盘已挂载，请关闭从端虚拟机或卸载云盘。 |
| 403 | OperationDenied | The operation is not allowed. | 当前操作不允许执行。 |
| 403 | OperationDenied.InvalidStatus | The operation is not allowed in current status. | 当前状态下该操作不允许执行。 |
| 403 | OperationDenied.ManualSyncLimit | One shot start manual syncing too frequently, please try again later. | 手动同步冷却时间未满足。 |
| 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. | 该请求超时，请稍后再重试。 |
访问错误中心查看更多错误码。