调用FailoverDiskReplicaPair启用异步复制关系的故障切换功能。当异步复制关系中主盘出现故障时，可以调用该接口恢复从盘的读写权限。
接口说明
- 异步复制功能支持的地域请参见云盘异步复制概述。
- 异步复制关系不能处于失效（
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 |
错误码 |
错误信息 |
描述 |
| 403 | OperationDenied | The operation is not allowed. | 当前操作不允许执行。 |
| 403 | OperationDenied.InvalidStatus | The operation is not allowed in current status. | 当前状态下该操作不允许执行。 |
| 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. | 该请求超时，请稍后再重试。 |
访问错误中心查看更多错误码。