更新时间:2023-11-21 GMT+08:00

缩容实例的节点数量

功能介绍

缩容指定实例的节点数量。

接口约束

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

  • GeminiDB Cassandra包年/包月实例和按需计费实例
  • GeminiDB Redis包年/包月实例和按需计费实例
  • GeminiDB Mongo包年/包月实例和按需计费实例

GeminiDB Redis实例支持的最大最小磁盘容量和节点数、规格相关,如果目标结果无法满足实例运行所需的磁盘大小,将无法缩容节点。

GeminiDB Mongo仅支持缩容只读节点。

该接口支持GeminiDB Redis搭建双活关系的主实例和备实例。

URI

POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/reduce-node

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

instance_id

String

实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

num

Integer

随机缩减的节点数量。

GeminiDB Cassandra实例该字段取值为1~10。

GeminiDB Redis该字段取值为1。

说明:

如果客户端采用直连节点方式,不推荐使用随机节点缩容。

node_list

Array of strings

指定缩容节点的ID,且该节点必须支持节点缩容。如果该字段不传指定缩减的节点ID,将根据系统内部策略缩减指定个数的节点。

说明:
  • num与node_list必须有一个字段传值。
    • 如果node_list传值时,GeminiDB Cassandra长度必须为1~10,GeminiDB Redis长度必须为1。
    • 如果num与node_list同时传值时,则以node_list的值为主。
  • 如果node_list取值为空时,缩容以随机节点缩容进行;node_list字段取值不为空,缩容以指定节点ID进行。
  • 节点缩容前,请避免直连节点,以防该节点缩容导致业务中断。

响应参数

状态码: 202

表4 响应Body参数

参数

参数类型

描述

job_id

String

任务ID,仅按需实例时会返回该参数。

order_id

String

订单ID,仅创建包年/包月实例时返回该参数。

请求示例

  • URI样例
    POST https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in06/reduce-node
  • 缩容1个实例节点
    {
       "num" : 1,
       "node_list" : [ "116ba14da34a42d28ecd83a38c218907no12" ]
    }

响应示例

状态码: 202

Accepted

按需实例响应样例:

{
  "job_id" : "04efe8e2-9255-44ae-a98b-d87cae411890"
}

包年/包月实例响应样例:

{
  "order_id" : "CS20070721568OVO9"
}

状态码

请参见状态码

错误码

请参见错误码