文档首页/ 云数据库 GeminiDB/ API参考/ API v3(推荐)/ 容灾管理/ 设置实例容灾切换的故障节点比例
更新时间:2024-12-02 GMT+08:00

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

功能介绍

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

接口约束

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

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" ] 
}

状态码

请参见状态码

错误码

请参见错误码