更新时间:2025-09-18 GMT+08:00

从空闲节点扩容

功能介绍

从空闲节点扩容。

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/clusters/{cluster_id}/resize-with-existed-nodes

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

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

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

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

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

scale_out

ScaleOut object

参数解释

扩容对象。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

force_backup

Boolean

参数解释

是否强制备份。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

mode

String

参数解释

扩容模式,不传默认离线read-only。

约束限制

在线模式在大部分低版本集群不支持,请在联系运维人员确认后方才可用。

取值范围

read-only:离线模式

insert:在线模式

默认取值

不涉及。

logical_cluster_name

String

参数解释

逻辑集群名称。

约束限制

不涉及。

取值范围

非逻辑集群模式下该字段不填,逻辑集群模式下不传默认elastic_group。

默认取值

elastic_group

expand_with_existed_node

Boolean

参数解释

是否是使用已添加的空闲节点进行扩容。

约束限制

不涉及。

取值范围

true:使用空闲节点扩容

false:不使用空闲节点扩容

默认取值

false

auto_redistribute

Boolean

参数解释

扩容完成后是否自动启动重分布,默认true。

约束限制

不涉及。

取值范围

不涉及。

默认取值

true

redis_conf

RedisConfReq object

参数解释

重分布配置信息。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

表3 ScaleOut

参数

是否必选

参数类型

描述

count

Integer

参数解释

扩容节点数。

取值范围

大于等于3。

subnet_id

String

参数解释

子网ID。

取值范围

同VPC下有效的子网ID。

表4 RedisConfReq

参数

是否必选

参数类型

描述

redis_mode

String

参数解释

重分布模式,不同模式对业务影响不同,修改建议联系运维人员评估后再决定。

约束限制

必须是有效的dws集群ID。

取值范围

offLine:离线模式。

onLine:在线模式。

默认取值

offLine

parallel_jobs

Integer

参数解释

并行作业数量,默认4。

约束限制

不涉及。

取值范围

1~200

默认取值

4

响应参数

状态码:200

从空闲节点扩容请求提交成功。

请求示例

从空闲节点扩容。

POST https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/resize-with-existed-nodes

{
  "scale_out" : {
    "count" : 3
  },
  "expand_with_existed_node" : true,
  "auto_redistribute" : true,
  "redis_conf" : {
    "redis_mode" : "offLine",
    "parallel_jobs" : 4
  }
}

响应示例

状态码

状态码

描述

200

从空闲节点扩容请求提交成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。