扩容集群
接口说明
扩容集群 包含以下三种功能: 1、扩容节点数量 支持对数据节点、冷数据节点、协调节点进行节点数量变更,选直调模式 2、扩容节点规格 支持对数据节点、Kibana节点、冷数据节点、协调节点、专用主节点进行规格扩容,可选冷重启模式和蓝绿模式 3、扩容节点磁盘 支持对数据节点、冷数据节点进行磁盘扩容,可选直调模式和蓝绿模式
只填写需要修改的必填参数,不填写的参数默认为修改前参数,如果变配参数和修改前参数一致,会返回resize no change;
缩容集群 包含缩容节点规格和缩容磁盘 kibana仅支持缩规格,数据节点和冷数据节点支持缩规格、磁盘(冷数据节点仅支持缩磁盘大小)、节点数量,专有主节点支持缩规格,协调节点支持缩规格、节点数量
注意:缩节点数量调用的不是本接口而是/api/bes/cluster/v2/instance/delete删除节点v2接口
缩容节点规格时除了kibana节点外仅支持蓝绿和冷重启,kibana节点仅支持冷重启;缩容磁盘类型时仅支持冷重启和蓝绿,缩容磁盘大小和cdsIO时仅支持蓝绿
注意:缩cdsIO仅支持pl2磁盘
请求URI
POST /api/bes/cluster/resize
请求头参数
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
x-Region | String | 是 | 区域 | bd |
请求体参数
请求体字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
clusterId | String | 是 | 集群ID,超过规定18位会返回500错误 | 570900694777860096 |
modules | List |
是 | 模板信息 | |
paymentType | String | 是 | 计费方式 | postpay表示后付费、prepay表示预付费 |
coupon | String | 否 | 可用代金券,缩容和后付费不用传 | 123456 |
resizeMode | String | 是 | 扩容、升配方式,如果resizeMode为空会报"Http Message Not Readable"。SCROLL:滚动模式,SMOOTH:蓝绿模式,COLD:冷重启模式,HOT:直调模式 | SCROLL |
isShrink | Boolean | 否 | 升配false,降配true,默认为false | false |
ModulesItem字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
type | String | 否 | 节点类型,es_node:数据节点,kibana:kibana节点,es_dedicated_master:专用主节点,es_cold_tier_node:冷数据节点,es_coordinate_node:协调节点 | kibana |
version | String | 否 | 集群版本 | 7.4.2 |
desireInstanceNum | Integer | 否 | 节点数量 | 1 |
slotType | String | 否 | 机型 | bes.c3.c1m2 |
diskSlotInfo | DiskSlotInfo | 否 | 磁盘信息 |
DiskSlotInfo字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
type | String | 否 | 磁盘类型;磁盘类型;ssd表示高效云盘、premium_ssd表示ssd云盘 | premium_ssd |
size | BigDecimal | 否 | 磁盘大小;单位G 最小为50G premium_ssd最大为6144G ssd最大为20480G | 50 |
cdsExtraIo | BigDecimal | 否 | 预配置IO | 100 |
响应体参数
响应体字段数据结构说明
参数名称 | 参数类型 | 描述 | 示例值 |
---|---|---|---|
success | Boolean | 请求是否成功 | true |
status | Integer | 状态码 | 200 |
result | Result | 返回信息 |
Result字段数据结构说明
参数名称 | 参数类型 | 描述 | 示例值 |
---|---|---|---|
orderId | String | 订单ID | 186f2566f2884534a65ed8cdc2499d82 |
请求示例
1POST /api/bes/cluster/resize
2<公共请求头>
3x-Region: bd
- 扩容节点数量
支持对数据节点、冷数据节点、协调节点进行节点数量变更,选直调模式
示例:
1{
2 "clusterId" : "570900694777860096",
3 "isShrink": false,
4 "modules": [
5 {
6 "type": "es_node",
7 "desireInstanceNum": 5
8 }
9 ],
10 "paymentType": "postpay",
11 "resizeMode": "HOT"
12}
- 扩容节点规格
支持对数据节点、Kibana节点、冷数据节点、协调节点、专用主节点进行规格扩容,可选冷重启模式和蓝绿模式
示例:
1{
2 "clusterId" : "570900694777860096",
3 "isShrink": false,
4 "modules": [
5 {
6 "type": "es_node",
7 "slotType": "bes.g3.c4m16"
8 }
9 ],
10 "paymentType": "postpay",
11 "resizeMode": "SMOOTH"
12}
- 扩容节点磁盘
支持对数据节点、冷数据节点进行磁盘扩容,可选直调模式和蓝绿模式
示例:
1{
2 "clusterId" : "570900694777860096",
3 "isShrink": false,
4 "modules": [
5 {
6 "type": "es_node",
7 "diskSlotInfo": {
8 "size": 100
9 }
10 }
11 ],
12 "paymentType": "postpay",
13 "resizeMode": "SMOOTH"
14}
- 变更磁盘类型
支持对数据节点变更磁盘类型,升配磁盘类型的同时,支持调整磁盘大小,可选直调模式和蓝绿模式
示例:
1{
2 "clusterId" : "570900694777860096",
3 "isShrink": false,
4 "modules": [
5 {
6 "type": "es_node",
7 "diskSlotInfo": {
8 "type":"enhanced_ssd_pl2",
9 "size": 500,
10 "cdsExtraIo": 100
11 }
12 }
13 ],
14 "paymentType": "postpay",
15 "resizeMode": "SMOOTH"
16}
响应示例
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "result" : {
6 "orderId" : "186f2566f2884534a65ed8cdc2499d82"
7 },
8 "success" : true,
9 "status" : 200
10}
错误码
请参考通用错误码