文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 容灾管理/ 设置实例容灾切换的故障节点比例
更新时间：2025-09-09 GMT+08:00
查看PDF
分享

设置实例容灾切换的故障节点比例

功能介绍

设置实例容灾切换的故障节点比例。

接口约束

该接口支持GeminiDB Cassandra数据库实例。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

PUT /v3/{project_id}/instances/disaster-recovery/settings

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一region下的project ID。获取方法请参见获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。
表3 请求Body参数

参数

是否必选

参数类型

描述

disaster_recovery_settings

否

Array of SwitchoverRatio objects

容灾切换的故障节点比例列表。
表4 SwitchoverRatio

参数

是否必选

参数类型

描述

instance_id

是

String

实例ID。

switchover_ratio

否

Integer

容灾切换的故障节点比例，下限是50，步长是10，最大是100，默认为100。

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

successed_instance_ids

Array of strings

设置容灾切换故障节点比例成功的实例列表。

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码： 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

设置实例容灾切换的故障节点比例。

PUT https://{endpoint}/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/disaster-recovery/settings 
 
{ 
  "disaster_recovery_settings" : [ { 
    "instance_id" : "d74162b942604190b991d1c39772a66ain06", 
    "switchover_ratio" : 50 
  }, { 
    "instance_id" : "e74162b942604190b991d1c39772a66ain06", 
    "switchover_ratio" : 100 
  } ] 
}

响应示例

状态码： 200

Success.

{ 
  "successed_instance_ids" : [ "d74162b942604190b991d1c39772a66ain06", "e74162b942604190b991d1c39772a66ain06" ] 
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 容灾管理

相关文档