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

添加节点类型

功能介绍

由于集群数据面业务的增长或者不确定性,创建集群时无法确定集群的规模形态,该接口能够在非独立master、client或冷数据节点的集群上面添加独立master、client或冷数据节点角色。

调用方法

请参见如何调用API

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/type/{type}/independent

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

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

约束限制

不涉及

取值范围

账户的项目ID。

默认取值

不涉及

cluster_id

String

参数解释

指定需要独立master、client或冷数据节点的集群ID。获取方法请参见获取集群ID

约束限制

不涉及

取值范围

集群ID。

默认取值

不涉及

type

String

参数解释

指定新增独立节点类型。

约束限制

不涉及

取值范围

  • ess-master:Master节点。

  • ess-client:Client节点。

  • ess-cold:冷数据节点。

默认取值

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

type

IndependentTypeReq object

参数解释

独立Master节点、Client节点或冷数据节点请求体参数。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表3 IndependentTypeReq

参数

是否必选

参数类型

描述

flavor_ref

String

参数解释

实例规格ID。

约束限制

不涉及

取值范围

参数通过获取实例规格列表接口获取,根据集群版本选择所需要的规格ID。

默认取值

不涉及

node_size

Integer

参数解释

独立节点个数。

约束限制

不涉及

取值范围

  • 如果路径参数type取值为“ess-master”即新增独立master节点,节点个数必须为大于等于3且小于等于9的奇数。

  • 如果路径参数type取值为“ess-client”即新增独立client节点,节点个数要求大于等于1小于等于64。

  • 如果路径参数type取值为“ess-cold”即新增独立冷数据节点,节点个数要求大于等于1小于等于32。如果是两AZ的集群,冷数据节点在各AZ的数量不小于2。

默认取值

不涉及

volume_type

String

参数解释

节点存储类型。

约束限制

flavor_ref参数是本地盘规格时,不能设置此参数。

取值范围

  • COMMON:普通I/O。

  • HIGH:高I/O。

  • ULTRAHIGH:超高I/O。

  • ESSD:极速SSD。

默认取值

flavor_ref参数不是本地盘规格时,默认取值ULTRAHIGH。

volume_size

Integer

参数解释

节点存储大小。

约束限制

  • flavor_ref参数是本地盘规格时,不能设置此参数。

  • 必须为大于0且为4和10的公倍数,单位:GB。

  • 新增独立冷数据节点:默认100G与节点规格支持的最小磁盘容量取较大者。

  • 新增独立master或client节点:默认大小为40G,且不可更改。

取值范围

磁盘规格大小可以通过过获取实例规格列表中diskrange属性获得。

默认取值

flavor_ref参数不是本地盘规格时:

说明:

新增独立冷数据节点,推荐大于100G。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

id

String

参数解释

集群ID。

取值范围

不涉及

请求示例

添加独立master、client或冷数据节点。

POST https://{Endpoint}/v1.0/{project_id}/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/type/ess-client/independent

{
  "type" : {
    "flavor_ref" : "d9dc06ae-b9c4-4ef4-acd8-953ef4205e27",
    "node_size" : 3,
    "volume_type" : "COMMON",
    "volume_size" : 40
  }
}

响应示例

状态码:200

请求成功。

{
  "id" : "320afa24-ff2a-4f44-8460-6ba95e512ad4"
}

状态码

状态码

描述

200

请求成功。

403

请求被拒绝访问。

返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

500

表明服务端能被请求访问到,但是不能理解用户的请求。

错误码

请参见错误码