5.5 委托管理
6.1.2 调整集群节点
"bootstrap_scripts" : [ { "name" : "Install zepplin",
"uri" : "s3a://XXX/zeppelin_install.sh", "parameters" : "",
"nodes" : [ "master" ], "active_master" : "false",
"before_component_start" : "false", "fail_action" : "continue"
} ] }
响应示例
状态码: 200 创建集群成功。
{ "cluster_id" : "da1592c2-bb7e-468d-9ac9-83246e95447a", "result" : true,
"msg" : ""
}
状态码
状态码 描述
200 创建集群成功。
错误码
请参见错误码。
6.1.2 调整集群节点
功能介绍
创建集群后,扩容/缩容集群Core节点或者Task节点。MRS集群创建成功后不支持调整 Master节点数量,即不支持扩缩容Master节点。该接口不兼容Sahara。 处于running 状态的集群才允许扩容/缩容,其他状态则不允许扩容/缩容。 集群状态和集群ID可参 考查询集群列表接口获取。
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
表6-15 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目编号。获取方法,请参见获 取项目ID。
cluster_id 是 String 集群ID。获取方法,请参见获取 集群ID。
请求参数
表6-16 请求 Body 参数
参数 是否必选 参数类型 描述
service_id 否 String 服务ID,为扩展接口,预留此参 数。用户不需要配置。
plan_id 否 String 套餐ID,为扩展接口,预留此参
数。用户不需要配置。
parameters 是 ClusterScalin gParams object
请求参数集合。
previous_valu
es 否 Map<String,St
ring> 扩展接口,预留此参数。用户不 需要配置。
表6-17 ClusterScalingParams
参数 是否必选 参数类型 描述
order_id 否 String 扩容/缩容时系统获取的订单
号,用户不需要配置。
scale_type 是 String ● scale_in:缩容
● scale_out:扩容
node_id 是 String 扩容/缩容时新增或者减少节点
的ID标识,参数值固定为 node_orderadd。
参数 是否必选 参数类型 描述
node_group 否 String 扩容或缩容的节点组。
● 如果node_group为
core_node_default_group,
表示Core节点组。
● 如果node_group为
task_node_default_group,
表示Task节点组。
该字段可以为空,为空时,系统 默认值为core_node_default_group。
skip_bootstra
p_scripts 否 String 是否跳过引导操作,默认为
false,即执行引导操作。 仅在 创建集群时配置了引导操作且扩 容时有意义,表示扩容时是否在 新增节点上执行创建集群时指定 的引导操作。
scale_without
_start 否 Boolean 扩容后是否启动扩容节点上的组
件。
● true:扩容后不启动组件。
● false:扩容后启动组件。
server_ids 否 Array of
strings 缩容Task节点时指定待删除Task 节点的ID列表。
● 当scale_type为扩容时,该参 数不生效。
● 当scale_type为缩容且该参数 不为空时,删除指定的Task 节点。
● 当scale_type为缩容且 server_ids为空时,按照系统 规则自动选择删除Task节 点。
参数 是否必选 参数类型 描述
instances 是 Integer 扩容或缩容的节点数。
● 扩容时的最大节点数为(500 - 集群Core/Task节点数)。
例如,当前集群Core节点数 为3,此处扩容的节点数必须 小于等于497。
Core和Task节点总数最大值 为500,如果用户需要的 Core/Task节点数大于500,
可以联系技术支持人员或者 调用后台接口修改数据库。
● 缩容时Core节点数大于3或者 Task节点数大于0可以进行节 点删除。例如,当前集群 Core节点和Task节点数均为 5,Core节点可缩容的节点数 为2(5减去3),Task节点可 缩容节点数为小于等于5。
task_node_inf
o 否 taskNodeInfo
object Task节点规格。
● 当Task节点个数为0时,使用 该字段指定Task节点的规 格。
● 当Task节点个数大于0时,不 能使用该字段。该字段为空 时,不填即可,字段内含必 填参数不可使用会传空值对 象的置空按钮。
表6-18 taskNodeInfo
参数 是否必选 参数类型 描述
node_size 是 String Task节点的实例规格,例如:
c3.4xlarge.2.linux.bigdata。实 例规格详细说明请参见MRS所 使用的弹性云服务器规格和 MRS所使用的裸金属服务器规 格。 该参数建议从MRS控制台 的集群创建页面获取对应区域对 应版本所支持的规格。
参数 是否必选 参数类型 描述 data_volume_
type 否 String Task节点数据磁盘存储类别,目
前支持SATA、SAS和SSD。
● SATA:普通IO
● SAS:高IO
● SSD:超高IO
● GPSSD:通用型SSD data_volume_
count 否 Integer Task节点数据磁盘存储数目,取
值范围:0~10。
data_volume_
size 否 Integer Task节点数据磁盘存储大小。
取值范围:100GB~
32000GB,传值只需填数字,
不需要带单位GB。
响应参数
状态码: 200
表6-19 响应 Body 参数
参数 参数类型 描述
result String 操作结果。
● succeeded:操作成功
● 操作失败时返回的错误码信息如错误码所示。
请求示例
● 扩容Core节点样例:
PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
{ "service_id" : "", "plan_id" : "", "parameters" : { "order_id" : "",
"scale_type" : "scale_out", "node_id" : "node_orderadd",
"node_group" : "core_node_default_group", "instances" : "1",
"skip_bootstrap_scripts" : false, "scale_without_start" : false }, "previous_values" : { } }
● 扩容Task节点(Task节点个数大于零时)样例:
PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
{ "service_id" : "", "plan_id" : "", "parameters" : { "order_id" : "",
"scale_type" : "scale_out", "node_id" : "node_orderadd",
"node_group" : "task_node_default_group", "instances" : "1",
"skip_bootstrap_scripts" : false, "scale_without_start" : false }, "previous_values" : { } }
● 扩容Task节点(Task节点个数为零时)样例:
PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
{ "service_id": "",
"node_group": "task_node_default_group", "task_node_info": {
"scale_without_start":false },
"previous_values": {}
}
● 缩容Core节点样例:
PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
{ "service_id": "",
"node_group": "core_node_default_group", "instances": "1",
},
"previous_values": {}
}
● 缩容Task节点样例:
PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
{ "service_id": "",
"node_group": "task_node_default_group", "instances": "1",
},
"previous_values": {}
}
● 缩容指定的Task节点样例:
PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
{ "service_id" : "", "plan_id" : "", "parameters" : { "order_id" : "",
"scale_type" : "scale_in", "node_id" : "node_orderadd",
"node_group" : "task_node_default_group", "instances" : "2",
"server_ids" : [ "c9573435-7814-4b2c-9131-ad78b814414c",
"a4951009-6a0f-4e7b-9c81-9d4bd1f8c537" ] }, "previous_values" : { }
}
响应示例
状态码: 200
扩容/缩容集群Core节点或者Task节点成功。
{ "result" : "succeeded"
}
状态码
状态码 描述
200 扩容/缩容集群Core节点或者Task节点成功。
错误码
请参见错误码。