文档首页/ 数据仓库服务 DWS/ 更多文档/ API参考（吉隆坡区域）/ API说明/ 节点变更/ 扩容集群
更新时间：2025-09-18 GMT+08:00
在线调试
CLI示例
查看PDF
分享

扩容集群

功能介绍

扩容集群，亦可用于添加空闲节点。默认情况下：表示执行扩容操作。

通过create_node_only字段用以区分当前是扩容、添加空闲节点：

  • true：仅添加空闲节点

  • false：表示执行扩容操作

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

cluster_id

是

String

参数解释：

集群ID。获取方法请参见获取集群ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

project_id

是

String

参数解释：

项目ID。获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

scale_out

否

ScaleOut object

参数解释：

扩容/添加空闲节点操作，节点信息请求体。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

create_node_only

否

Boolean

参数解释：

当前是否仅添加空闲节点。

约束限制：

不涉及。

取值范围：

true：仅添加节点，如需扩容则需要单独操作

false：添加节点并扩容集群

默认取值：

false

waiting_for_killing

否

Integer

参数解释：

自动查杀作业等待时间。

约束限制：

guestAgent插件版本8.2.1及以上才支持。

取值范围：

30~1200

默认取值：

0，即不限制。

auto_redistribute

否

Boolean

参数解释：

扩容完成后是否自动启动重分布，默认是。如果设置为false，扩容后不进行重分布，此时集群任务信息处于“待重分布”状态，无法进行其他操作。

约束限制：

不涉及。

取值范围：

true：扩容后立即重分布。

false：扩容后不进行重分布，此时集群任务信息处于“待重分布”状态。

默认取值：

true
表3 ScaleOut

参数

是否必选

参数类型

描述

count

是

Integer

参数解释：

扩容节点数。

取值范围：

大于等于3。

subnet_id

否

String

参数解释：

子网ID。

取值范围：

同VPC下有效的子网ID。

响应参数

状态码：200

扩容集群请求下发成功。

无

请求示例

  • 扩容集群新增3节点。

    POST https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/resize

{
  "scale_out" : {
    "count" : 3
  }
}

  • 给集群添加3个空闲节点，用于后续示例3的扩容操作。

    POST https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/resize

{
  "scale_out" : {
    "count" : 3
  },
  "create_node_only" : true
}

响应示例

状态码：200

扩容集群请求下发成功。

{ }

状态码

状态码

描述

200

扩容集群请求下发成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。
父主题： 节点变更