更新时间：2026-09-03 GMT+08:00

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

功能介绍

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

接口约束

集群的节点存储容量只支持扩容不支持缩容，请基于业务量合理选择节点存储容量。
按需集群支持同时扩容“节点数量”和“节点存储容量”。
集群的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~64。冷数据节点：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	所请求的资源不存在。建议直接修改该请求，不要重试该请求。

描述

200

请求成功。

400

非法请求。

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

404

所请求的资源不存在。