Modifying the Specifications of an ECS (V1.1)
Function
This API is used to modify ECS specifications.
Constraints
- You can modify the ECS specifications only when the ECS is stopped.
- Spot ECSs do not support specifications modification.
- The flavor (memory and vCPUs) after the modification cannot be lower than that before the modification.
URI
POST /v1.1/{project_id}/cloudservers/{server_id}/resize
Parameter |
Mandatory |
Description |
---|---|---|
project_id |
Yes |
Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. |
server_id |
Yes |
Specifies the ECS ID. You can obtain the ECS ID from the console or by following the instructions provided in "Querying Details About an ECS". |
Request
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
resize |
Yes |
Object |
Specifies the operation to modify ECS specifications. For details, see Table 2. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
flavorRef |
Yes |
String |
Specifies the flavor ID of the ECS after the modification. You can view Querying the Target ECS Flavors to Which a Flavor Can Be Changed to query the target flavors to which a specified ECS flavor can be changed.
NOTE:
|
dedicated_host_id |
No |
String |
Specifies the new DeH ID, which is applicable only to the ECSs on DeHs. |
extendparam |
No |
Object |
Modify the extended information about an ECS. For details, see Table 3. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
isAutoPay |
No |
String |
Specifies whether the order is automatically or manually paid.
NOTE:
This parameter is valid only for yearly/monthly ECSs. When this parameter is left blank, the order must be manually paid by default. |
Response
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
job_id |
No |
String |
Specifies the task ID. This parameter is returned when you modify the specifications of a pay-per-use ECS. For details about task statuses, see Querying Task Execution Status. |
order_id |
No |
String |
Specifies the order ID. This parameter is returned when you modify the specifications of a yearly/monthly ECS. |
Example Request
POST https://{endpoint}/v1.1/{project_id}/cloudservers/{server_id}/resize
{ "resize": { "flavorRef": "s3.large.2", "dedicated_host_id": "459a2b9d-804a-4745-ab19-a113bb1b4ddc", "extendparam":{ "isAutoPay": "true" }, } }
Example Response
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
Or
{ "order_id": "CS1711152257C60TL", "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
Or
{ "error": { "message": "XXXX", "code": "XXX" } }
Returned Values
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.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot