Autoscaler Related Interfaces
Updated at：2025-10-27
Query Autoscaler configuration
Description
Query cluster Autoscaler configuration
Request structure
Plain Text
1GET /v2/autoscaler/{clusterID} HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization stringRequest headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Required or not | Parameter location | Description |
|---|---|---|---|---|
| clusterID | String | Yes | URL parameter | Cluster ID |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Required or not | Description |
|---|---|---|---|
| autoscaler | [Autoscaler](CCE/API_V2 Reference/Appendix.md#Autoscaler) | Yes | Queried Autoscaler information |
| requestID | String | Yes | Request ID. This ID is provided for issue localization. |
Request example
Plain Text
1GET /v2/autoscaler/cce-uqc4lju1 HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1deResponse example
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 6836119a-99e1-4448-b469-1199c3fb1b07
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5{
6 "autoscaler": {
7 "clusterID": "cce-uqc4lju1",
8 "clusterName": "sdk-ccev2-test2",
9 "caConfig": {
10 "replicaCount": 2,
11 "scaleDownEnabled": true,
12 "scaleDownUtilizationThreshold": 50,
13 "scaleDownGPUUtilizationThreshold": 50,
14 "scaleDownUnneededTime": 10,
15 "scaleDownDelayAfterAdd": 10,
16 "maxEmptyBulkDelete": 10,
17 "skipNodesWithLocalStorage": true,
18 "skipNodesWithSystemPods": false,
19 "expander": "random",
20 "customConfigs": {
21 "--node-deletion-delay-timeout": "3m"
22 }
23 }
24 },
25 "requestID": "41d2b661-fe2f-4454-a017-5060795a0ac6"
26}Create Autoscaler
Description
Create cluster Autoscaler
Request structure
Plain Text
1POST /v2/autoscaler/{clusterID} HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization stringRequest headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Required or not | Parameter location | Description |
|---|---|---|---|---|
| clusterID | String | Yes | URL parameter | Cluster ID |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Required or not | Description |
|---|---|---|---|
| requestID | String | Yes | Request ID. This ID is provided for issue localization. |
Request example
Plain Text
1POST /v2/autoscaler/cce-uqc4lju1 HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1deResponse example
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: b339ba19-1a26-49f5-9cec-74b5a7a080c6
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5{
6 "requestID": "b339ba19-1a26-49f5-9cec-74b5a7a080c6"
7}Update Autoscaler configuration
Description
Update cluster Autoscaler configuration
Request structure
Plain Text
1PUT /v2/autoscaler/{clusterID} HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization stringRequest headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Required or not | Parameter location | Description |
|---|---|---|---|---|
| clusterID | String | Yes | URL parameter | Cluster ID |
| expander | String | Yes | RequestBody | Auto scaling group selection strategy. Options: [random, most-pods, least-waste, priority], defaulting to random. |
| instanceGroups | List<[ClusterAutoscalerInstanceGroup](CCE/API_V2 Reference/Appendix.md#ClusterAutoscalerInstanceGroup)> | No | RequestBody | Autoscaler configuration in the node group. Users need not input this content. |
| kubeVersion | String | No | RequestBody | K8S version. When null, the backend automatically queries the cluster K8S version No. |
| maxEmptyBulkDelete | Integer | No | RequestBody | Maximum concurrent scale-down count |
| scaleDownDelayAfterAdd | Integer | No | RequestBody | Scale-down start latency after scale-up, in minutes |
| scaleDownEnabled | Boolean | No | RequestBody | Start scale-down, defaulting to false |
| scaleDownGPUUtilizationThreshold | Integer | No | RequestBody | GPU scale-down threshold percentage, value range (0, 100). |
| scaleDownUnneededTime | Integer | No | RequestBody | Scale-down trigger latency, in minutes. |
| scaleDownUtilizationThreshold | Integer | No | RequestBody | Scale-down threshold percentage, value range (0, 100). |
| skipNodesWithLocalStorage | Boolean | No | RequestBody | Whether to skip the nodes stored locally, defaulting to true. |
| skipNodesWithSystemPods | Boolean | No | RequestBody | Whether to skip the nodes with system pods deployed, defaulting to true. |
| customConfigs | Map<String,String> | No | RequestBody | User-defined configuration. |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Required or not | Description |
|---|---|---|---|
| requestID | String | Yes | Request ID. This ID is provided for issue localization. |
Request example
Plain Text
1PUT /v2/autoscaler/cce-br0i4kl5 HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "scaleDownEnabled": true,
6 "scaleDownUtilizationThreshold": 50,
7 "scaleDownGPUUtilizationThreshold": 50,
8 "scaleDownUnneededTime": 10,
9 "scaleDownDelayAfterAdd": 10,
10 "maxEmptyBulkDelete": 10,
11 "skipNodesWithLocalStorage": true,
12 "skipNodesWithSystemPods": false,
13 "expander": "random",
14 "customConfigs": {
15 "--node-deletion-delay-timeout": "3m"
16 }
17}Response example
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 3d61a898-b804-4d6f-8c7c-b741d2ffbe45
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5{
6 "requestID": "3d61a898-b804-4d6f-8c7c-b741d2ffbe45"
7}