调用FailoverDiskReplicaPair启用异步复制关系的故障切换功能。当异步复制关系中主盘出现故障时，可以调用该接口恢复从盘的读写权限。
接口说明
- 异步复制功能支持华东1（杭州）、华东2（上海）、华北2（北京）、华南1（深圳）、华南2（河源）、西南1（成都）、中国（香港）、新加坡、美国（硅谷）和美国（弗吉尼亚）地域。
- 异步复制关系不能处于失效（
invalid）或已删除（deleted）状态。 - 故障切换完成后，异步复制关系处于故障切换完成（
failovered）状态。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | FailoverDiskReplicaPair |
系统规定参数。取值：FailoverDiskReplicaPair。 |
| RegionId | String | 是 | cn-shanghai |
异步复制关系中从盘所属的地域ID。您可以调用DescribeDiskReplicaPairs查询异步复制关系中从盘的地域信息。 说明 必须在从盘所属地域下启用故障切换功能。
|
| ReplicaPairId | String | 是 | pair-cn-dsa**** |
异步复制关系的ID。 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** |
保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | C123F94F-4E38-19AE-942A-A8D6F44F**** |
请求ID。 |
示例
请求示例
http(s)://ebs.cn-shanghai.aliyuncs.com/?Action=FailoverDiskReplicaPair
&RegionId=cn-shanghai
&ReplicaPairId=pair-cn-dsa****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<FailoverDiskReplicaPairResponse>
<RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
</FailoverDiskReplicaPairResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F****"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的RegionId不存在。 |
| 404 | InvalidZoneId.NotFound | The specified ZoneId does not exist. | 指定的ZoneId不存在。 |
| 404 | NoSuchResource | The specified resource does not exist. | 指定的资源不存在。 |
| 504 | RequestTimeout | The request is timeout, please try again later. | 该请求超时，请稍后再重试。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
| 403 | InvalidPayMethod | The specified pay method is not valid. | 不支持该购买方式。请检查您传入的参数chargeType是否正确。 |
| 403 | Forbidden | User is not authorized to operate. | 当前用户无权限对当前资源执行任何操作。请检查您的账号权限或者咨询您的主账号管理员。 |
| 403 | Forbidden.Action | User is not authorized to operate this action. | 当前用户无权限执行该操作。请检查您的账号权限或者咨询您的主账号管理员。 |
| 403 | NoPermission.SLR | The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS. | 当前用户无权限创建SLR。 |
| 403 | LastTokenProcessing | The last token request is processing. | 相同clientToken的请求正在执行，请稍后再重试。 |
| 403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 您的账户余额不足。 |
| 403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | 当前操作不支持您指定的磁盘类型。请检查您的输入参数和API文档。 |
| 403 | OperationDenied | The operation is not allowed. | 当前操作不允许执行。 |
| 403 | OperationDenied.QuotaExceed | The operation is not allowed due to quota exceed. | 当前操作已超过使用配额。 |
| 403 | NotOnSale.Region | The specified region is not on sale. | 当前Region停售或无库存。 |
| 403 | NotOnSale.Zone | The specified zone is not on sale. | 当前Zone停售或无库存。 |
| 403 | OperationDenied.PairInAnotherGroup | The operation is not allowed because pair is already in another group. | 当前操作不允许执行，因为复制对已被加入另一个一致性组中。 |
| 403 | OperationDenied.PairNotInGroup | The operation is not allowed because pair is not in any group. | 当前操作不允许执行，因为指定的异步复制对未加入任何一致性组中。 |
| 403 | OperationDenied.NoPairInGroup | The operation is not allowed because no pair in the group. | 当前操作不允许执行，因为指定的一致性组中没有复制对。 |
| 403 | OperationDenied.PairsExceedInGroup | The operation is not allowed due to too much pair in the group. | 当前操作不允许执行，因为已超过一致性组可支持的最大复制对数量。 |
| 403 | OperationDenied.ManualSyncLimit | One shot start manual syncing too frequently, please try again later. | 手动同步冷却时间未满足。 |
| 403 | OperationDenied.GroupTotalDiskCapacityLimit | Operation failed because of total disk capacity in group over limit. | 复制组中的云盘总容量过大。 |
访问错误中心查看更多错误码。