集群扩容前检查
功能介绍
集群扩容前检查,提前识别子网不足、权限不足等问题导致的扩容失败。
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/clusters/{cluster_id}/grow-check
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
scale_out |
否 |
ScaleOut object |
参数解释: 扩容/添加空闲节点操作,节点信息请求体。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
create_node_only |
否 |
Boolean |
参数解释: 当前是否仅添加空闲节点。 约束限制: 不涉及。 取值范围: true:仅添加节点,如需扩容则需要单独操作 false:添加节点并扩容集群 默认取值: false |
waiting_for_killing |
否 |
Integer |
参数解释: 自动查杀作业等待时间。 约束限制: guestAgent插件版本8.2.1及以上才支持。 取值范围: 30~1200 默认取值: 0,即不限制。 |
auto_redistribute |
否 |
Boolean |
参数解释: 扩容完成后是否自动启动重分布,默认是。如果设置为false,扩容后不进行重分布,此时集群任务信息处于“待重分布”状态,无法进行其他操作。 约束限制: 不涉及。 取值范围: true:扩容后立即重分布。 false:扩容后不进行重分布,此时集群任务信息处于“待重分布”状态。 默认取值: true |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
data |
Array of GrowCheckResult objects |
参数解释: 扩容前检查信息。 取值范围: 不涉及。 |
note |
NoteInfo object |
参数解释: 扩容前提示信息。 取值范围 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
pass |
Boolean |
参数解释: 检查是否通过,检查通过项默认不展示。 取值范围: true/false |
reason |
String |
参数解释: 检查不通过的原因描述。 取值范围: 不涉及。 |
required |
Boolean |
参数解释: 是否必须检查项。 取值范围:
|
desc |
String |
参数解释: 描述信息。 取值范围: 不涉及。 |
type |
String |
参数解释: 分类。 取值范围: 配额、权限、版本、状态 |
参数 |
参数类型 |
描述 |
---|---|---|
current_dn_num |
Integer |
参数解释: 当前DN数。 取值范围: 不涉及。 |
after_scale_out_dn_num |
Integer |
参数解释: 扩容后DN数。 取值范围: 不涉及。 |
current_bucket_num |
Integer |
参数解释: 当前bucket数。 取值范围: 不涉及。 |
after_scale_out_bucket_num |
Integer |
参数解释: 扩容后bucket数。 取值范围: 不涉及。 |
is_bucket_split |
Boolean |
参数解释: 扩容是否涉及bucket分裂。 取值范围: 不涉及。 |
bucket_tilt_rate |
String |
参数解释: bucket DN倾斜率,用于衡量bucket在DN节点上不均衡程度。 取值范围: 不涉及。 |
after_scale_out_bucket_tilt_rate |
String |
参数解释: 扩容后 bucket DN倾斜率,用于衡量扩容后bucket在DN节点上不均衡程度。 取值范围: 不涉及。 |
请求示例
扩容集群新增3节点,检查是否存在配额或权限等问题。
POST https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/grow-check { "scale_out" : { "count" : 3 } }
响应示例
状态码:200
请求下发成功。
{ "note" : { "bucket_split_info" : { "current_dn_num" : 6, "after_scale_out_bucket_num" : 32, "is_bucket_split" : false, "after_scale_out_dn_num" : 9, "bucket_tilt_rate" : "16.67%", "after_scale_out_bucket_tilt_rate" : "25.00%" } }, "data" : [ { "pass" : false, "reason" : "子网IP超过配额:需要量 3,使用量 249 / 251", "required" : true, "desc" : "子网IP检查", "type" : "配额" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
请求下发成功。 |
400 |
请求错误。 |
401 |
鉴权失败。 |
403 |
没有操作权限。 |
404 |
找不到资源。 |
500 |
服务内部错误。 |
503 |
服务不可用。 |