更新时间:2025-09-18 GMT+08:00

容灾异常切换

功能介绍

该接口用于容灾异常场景下进行主备集群切换操作。

“异常切换”按钮用于容灾异常或者生产集群故障情况下主备切换操作。

容灾异常切换仅8.1.2及以上集群版本支持。

异常切换会将灾备集群升为主,若原生产集群故障后存在部分数据未同步到灾备集群,那灾备集群升主后将缺少这些数据,切换时请确认容灾最后同步时间,谨慎操作。

仅支持DWS 2.0集群。

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/disaster-recovery/{disaster_recovery_id}/failover

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

disaster_recovery_id

String

参数解释

容灾ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

disaster_recovery

DisasterRecoveryId object

参数解释

容灾ID对象。

取值范围

不涉及。

表3 DisasterRecoveryId

参数

参数类型

描述

id

String

参数解释

容灾ID。

取值范围

不涉及。

请求示例

POST https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/disaster-recovery/e59d6b86-9072-46eb-a996-13f8b44994c1/failover

响应示例

状态码:200

异常切换下发成功。

{
  "disaster_recovery" : {
    "id" : "e59d6b86-9072-46eb-a996-13f8b44994c1"
  }
}

状态码

状态码

描述

200

异常切换下发成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。