文档首页/ 云搜索服务 CSS/ 更多文档/ API参考（联盟区域）/ API V1/ 集群管理/ 扩容实例的数量和存储容量
更新时间：2026-01-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

扩容实例的数量和存储容量

功能介绍

当集群的数据量持续增长或内存占用过高时，集群可能无法有效应对业务负载和性能需求。此时，可以扩容节点的数量和存储容量。

接口约束

  • 集群的节点存储容量只支持扩容不支持缩容，请基于业务量合理选择节点存储容量。

  • 按需集群支持同时扩容“节点数量”和“节点存储容量”。

  • 集群的Master节点和Client节点的存储容量不支持扩容。

  • 本地盘类型的数据节点不支持扩容节点存储容量。

  • Logstash集群只支持扩容节点数量，不支持扩容存储容量。

调用方法

请参见如何调用API。

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/role_extend

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID。获取方法请参见获取项目ID和名称。

约束限制：

不涉及

取值范围：

账户的项目ID。

默认取值：

不涉及

cluster_id

是

String

参数解释：

指定扩容的集群ID。获取方法请参见获取集群ID。

约束限制：

不涉及

取值范围：

集群ID。

默认取值：

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

grow

是

Array of RoleExtendGrowReq objects

参数解释：

集群扩容请求的详细描述。

约束限制：

不涉及
表3 RoleExtendGrowReq

参数

是否必选

参数类型

描述

type

是

String

参数解释：

待扩容的节点类型。

约束限制：

ess-master、ess-client、lgs节点只支持增加实例个数。

取值范围：

  • ess：数据节点。

  • ess-master：Master节点。

  • ess-client：Client节点。

  • ess-cold：冷数据节点。

  • lgs：Logstash集群创建的Logstash节点。

可以选择其中一个或多个之间的组合，但不可以重复选择。

说明：

lgs不支持和其他一起组合。

默认取值：

不涉及

nodesize

是

Integer

参数解释：

增加的实例个数。

约束限制：

集群扩容后，各类型节点的数量需要满足以下要求：

  • 数据节点：集群没有Master节点时：1~32个，集群有Master节点时：1~200个。

  • Master节点：3、5、7、9(必须是3~9之间的奇数)。

  • Client节点：1~32。

  • 冷数据节点：1~32。

  • Logstash节点：1~100。

取值范围：

参考约束限制。

默认取值：

不涉及

disksize

是

Integer

参数解释：

扩容实例存储容量，单位：GB。

约束限制：

集群原实例存储容量和扩容实例存储容量之和不能超过创建集群时对应默认实例存储容量上限。若无需扩容该参数将该参数设置为0即可。

取值范围：

  • ess节点、ess-cold节点扩容步长为20。

  • ess-master节点、ess-client节点不允许扩容存储。

  • Logstash不支持扩容存储容量。

  • 多个约束分行，无序排列。

默认取值：

不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

id

String

参数解释：

集群ID。

取值范围：

不涉及

请求示例

修改当前集群的实例个数与存储容量。

POST https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/role_extend

{
  "grow" : [ {
    "type" : "ess-master",
    "nodesize" : 2,
    "disksize" : 0
  }, {
    "type" : "ess",
    "nodesize" : 0,
    "disksize" : 40
  }, {
    "type" : "ess-client",
    "nodesize" : 1,
    "disksize" : 0
  }, {
    "type" : "ess-cold",
    "nodesize" : 1,
    "disksize" : 0
  } ],
  "is_auto_pay" : 1
}

响应示例

状态码：200

请求已成功。

{
  "id" : "4f3deec3-efa8-4598-bf91-560aad1377a3"
}

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求，不要重试该请求。

404

所请求的资源不存在。

建议直接修改该请求，不要重试该请求。

错误码

请参见错误码。

父主题： 集群管理