文档首页/ 云数据库 GeminiDB/ API参考/ API v3(推荐)/ 实例管理/ 查询节点自动扩容策略 - QueryinganAutomaticScale-outPolicy
更新时间:2025-11-12 GMT+08:00
分享

查询节点自动扩容策略 - QueryinganAutomaticScale-outPolicy

功能介绍

查询节点自动扩容策略。

接口约束

该接口支持如下数据库实例:

  • GeminiDB Cassandra

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限策略和授权项

URI

GET /v3/{project_id}/instances/{instance_id}/node-auto-expansion-policy

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

instance_id

String

参数解释:

实例ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

无。

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

switch_option

Boolean

参数解释:

节点扩容是否开启。

约束限制:

不涉及。

取值范围:

  • true:表示开启。
  • false:表示关闭。

默认取值:

不涉及。

overload_node_threshold

Integer

参数解释:

超负载节点比例。当大等于overload_node_threshold%的节点,节点内存使用率或cpu使用率满足条件时,触发自动扩容节点。

约束限制:

不涉及。

取值范围:

1-100的正整数。

默认取值:

不涉及。

cpu_threshold

Integer

参数解释:

触发节点自动扩容的CPU使用率。

约束限制:

不涉及。

取值范围:

1~100的正整数。

默认取值:

不涉及。

mem_threshold

Integer

参数解释:

触发节点自动扩容的内存使用率。

约束限制:

不涉及。

取值范围:

1~100的正整数。

默认取值:

不涉及。

step

Integer

参数解释:

每次扩容的节点个数。

约束限制:

不涉及。

取值范围:

大等于1的正整数,最大不超过可扩容的节点上限。

默认取值:

不涉及。

node_limit

Integer

参数解释:

自动扩容所能达到的节点上限。

约束限制:

不涉及。

取值范围:

大等于1的正整数,最大不超过当前实例可扩容的节点上限。

默认取值:

不涉及。

请求示例

节点自动扩容策略

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/3d39c18788b54a919bab633874c159dfin02/auto-node-expansion-policy

响应示例

状态码: 200

Success.

{    
  "switch_option" : "true",
  "overload_node_threshold" : "33",
  "cpu_threshold" : "80", 
  "mem_threshold" : "80",   
  "step" : "3",   
  "node_limit" : "10" 
 }

状态码

请参见状态码

错误码

请参见错误码

相关文档