文档首页/ 云搜索服务 CSS/ 更多文档/ API参考（联盟区域）/ API V1/ 集群管理/ 添加独立master、client
更新时间：2026-01-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

添加独立master、client

功能介绍

由于集群数据面业务的增长或者不确定性，很难在一开始就能够把集群的规模形态想明白，该接口能够在非独立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节点。

默认取值：

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

type

是

IndependentTypeReq object

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表3 IndependentTypeReq

参数

是否必选

参数类型

描述

flavor_ref

是

String

参数解释：

实例规格ID。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

node_size

是

Integer

参数解释：

独立节点个数。

约束限制：

不涉及

取值范围：

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

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

默认取值：

不涉及

volume_type

是

String

参数解释：

节点存储类型。

约束限制：

不涉及

取值范围：

  • COMMON：普通I/O。

  • HIGH：高I/O。

  • ULTRAHIGH：超高I/O。

  • ESSD：极速SSD。

默认取值：

不涉及

响应参数

状态码：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"
  }
}

响应示例

状态码：200

请求已成功。

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

状态码

状态码

描述

200

请求已成功。

403

请求被拒绝访问。

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

500

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

错误码

请参见错误码。

父主题： 集群管理