节点管理相关接口
更新时间：2025-08-20
释放节点
接口描述
手动释放指定的实例
请求结构
Method: POST
请求URL: /v1/group/{groupId}?scalingDown
请求参数
| 参数名 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| groupId | String | 是 | RequestQuery参数 | 伸缩组id |
| nodes | List<String> | 是 | RequestBody参数 | 释放实例短 id 列表 |
响应参数
无响应参数
请求示例
JSON
1POST /v1/group/asg-LfZn4Zc2?scalingDown
2
3 {
4 "nodes": ["i-rumIPsss"]
5}响应示例
无返回
添加节点
接口描述
手动添加实例
请求结构
Method: POST
请求URL: /v1/group/{groupId}?scalingUp
请求参数
| 参数名 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| groupId | String | 是 | RequestQuery参数 | 伸缩组id |
| nodeCount | int | 否 | RequestBody参数 | 手动扩容节点数量, 不填为0 |
| zone | List<String> | 是 | RequestBody参数 | 手动扩容可指定可用区（扩容时会与伸缩组配置的可用区取交集） |
| expansionStrategy | String | 否 | RequestBody参数 | 扩容时的可用区选择策略包括: Priority 和 Balanced。Priority - 以单独可用区进行创建，Balanced - 在选定可用区中均衡创建 。如果未设置，则默认选择伸缩组的策略 |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| success | boolean | 是否成功 |
| msg | String | 失败原因 |
请求示例
JSON
1POST /v1/group/asg-LfZn4Zc2?scalingUp
2
3 {
4 "nodeCount":1,
5 "zone":["zoneB"],
6 "expansionStrategy":"Priority"
7}响应示例
JSON
1{
2 "success": true,
3 "msg": ""
4}移入节点
接口描述
将已有实例添加至指定伸缩组
请求结构
Method: POST
请求URL: /v1/group/{groupId}?attachNode
请求参数
| 参数名 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| groupId | String | 是 | RequestQuery参数 | 伸缩组id |
| nodes | List<String> | 是 | RequestBody参数 | 待移入实例短id列表 |
响应参数
无响应参数
请求示例
JSON
1POST /v1/group/asg-LfZn4Zc2?attachNode
2{
3 "nodes": [
4 "i-rumIPsss"
5 ]
6}响应示例
无返回
移出节点
接口描述
将伸缩组中指定实例移出伸缩组
请求结构
Method: POST
请求URL: /v1/group/{groupId}?detachNode
请求参数
| 参数名 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| groupId | String | 是 | RequestQuery参数 | 伸缩组id |
| nodes | List<String> | 是 | RequestBody参数 | 待移入实例短id列表 |
响应参数
无响应参数
请求示例
JSON
1POST /v1/group/asg-LfZn4Zc2?detachNode
2{
3 "nodes": [
4 "i-rum****s"
5 ]
6}响应示例
无返回
移出节点
接口描述
将伸缩组中指定实例移出伸缩组
请求结构
Method: POST
请求URL: /v1/group/{groupId}?detachNode
请求参数
| 参数名 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| groupId | String | 是 | RequestQuery参数 | 伸缩组id |
| nodes | List<String> | 是 | RequestBody参数 | 待移入实例短id列表 |
响应参数
无响应参数
请求示例
JSON
1POST /v1/group/asg-LfZn4Zc2?detachNode
2{
3 "nodes": [
4 "i-rum****s"
5 ]
6}响应示例
无返回
修改节点保护
接口描述
修改伸缩组中节点的保护状态
请求结构
Method: POST
请求URL: /v1/group/{groupId}?updateProtect
请求参数
| 参数名 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| groupId | String | 是 | RequestQuery参数 | 伸缩组id |
| nodes | List<String> | 是 | RequestBody参数 | 待移入实例短id列表 |
| isProtected | Boolean | 是 | RequestBody参数 | 是否将nodes中节点设置为保护节点 |
响应参数
无响应参数
请求示例
JSON
1POST /v1/group/asg-LfZn4Zc2?updateProtect
2{
3 "nodes": [
4 "i-rum****s"
5 ],
6 "isProtected": false
7}响应示例
无返回
修改节点托管状态
接口描述
修改伸缩组中节点的托管状态
请求结构
Method: POST
请求URL: /v1/node/{groupId}?updateIsManaged
请求参数
| 参数名 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| groupId | String | 是 | RequestQuery参数 | 伸缩组id |
| addManagedNodeIds | List<String> | 是 | RequestBody参数 | 新增托管的节点列表 |
| delManagedNodeIds | List<String> | 是 | RequestBody参数 | 取消托管的节点列表 |
响应参数
无响应参数
请求示例
JSON
1POST /v1/node/asg-LfZn4Zc2?updateIsManaged
2{
3 "addManagedNodeIds": ["i-FMaW****"],
4 "delManagedNodeIds": ["i-FMaW****", "i-FMaWW321"]
5}响应示例
无返回