调用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
C123F94F-4E38-19AE-942A-A8D6F44F****
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. | 该请求超时,请稍后再重试。 |
访问错误中心查看更多错误码。
腾讯云1折,限时活动,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
转转请注明出处:https://www.yunxiaoer.com/153222.html