Modifying Cluster Specifications
Function
This API is used to modify the specifications of a cluster.

- The URL for cluster management is in the format of https://Endpoint/uri, in which uri indicates the resource path, that is, the path for API access.
URI
POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/resize
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. |
cluster_id |
Yes |
String |
Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
Content-Type |
Yes |
String |
Message body type (format). |
X-Auth-Token |
Yes |
String |
Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
flavorResize |
Yes |
String |
The target flavor to be changed. You can only adjust the maximum number of worker nodes in a cluster. The number of master nodes is fixed and cannot be altered, and the cluster flavors cannot be downgraded. Suppose the original cluster flavor is cce.s2.medium. In that case, you can only upgrade it to cce.s2.large or higher, but you cannot downgrade it to cce.s2.small or cce.s1.medium.
NOTE:
The fields in the parameters are described as follows:
|
extendParam |
No |
extendParam object |
- |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
decMasterFlavor |
No |
String |
Specifications of the master node in the dedicated hybrid cluster |
isAutoPay |
No |
String |
Whether auto payment is enabled.
NOTE:
This field is valid for yearly/monthly clusters. If not specified, auto payment is not enabled. |
Response Parameters
Status code: 201
Parameter |
Type |
Description |
---|---|---|
jobID |
String |
ID of the job |
orderID |
String |
ID of the order for modifying the specifications of a yearly/monthly billed cluster |
Example Requests
- Modifying the specifications of the yearly/monthly cluster (automatic payment)
POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/resize { "flavorResize" : "cce.s1.medium", "extendParam" : { "isAutoPay" : "true" } }
- Modifying the specifications of the pay-per-use cluster
POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/resize { "flavorResize" : "cce.s1.medium" }
Example Responses
Status code: 201
The job for modifying the specifications of the pay-per-use cluster is delivered.
{ "jobID" : "13b8d958-8fcf-11ed-aef3-0255ac1001bd" }
Status Codes
Status Code |
Description |
---|---|
201 |
The job for modifying the specifications of the pay-per-use cluster is delivered. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.