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

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

功能介绍

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

接口约束

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    gaussdbfornosql:instance:setDisasterSettings

    write

    -

    -

    nosql:dr:setDisasterRecoverySettings

    -

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

状态码

请参见状态码。

错误码

请参见错误码。

父主题：容灾管理

相关文档