Restarting ECSs in a Batch¶
Function¶
This API is used to restart ECSs in a batch based on specified ECS IDs. A maximum of 1000 ECSs can be restarted at a time.
URI¶
POST /v1/{project_id}/cloudservers/action
Table 1 describes the parameters in the URI.
Parameter | Mandatory | Description |
---|---|---|
project_id | Yes | Specifies the project ID. |
Request¶
Table 2 describes the request parameters.
Parameter | Mandatory | Type | Description |
---|---|---|---|
reboot | Yes | Object | Specifies the operation to restart the ECS. For details, see Table 3. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
type | Yes | String | Specifies the type of the restart operation.
|
servers | Yes | Array of objects | Specifies ECS IDs. For details, see Table 4. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
id | Yes | String | Specifies the ECS ID. |
Response¶
See Responses (Task).
Example Request¶
In the request, the parameters to restart ECSs must be sent with field reboot. For details, see the example request.
POST https://{endpoint}/v1/{project_id}/cloudservers/action
{
"reboot": {
"type":"SOFT",
"servers": [
{
"id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
},
{
"id": "726fb98f-46ca-475e-917e-2563e5a8cd20"
}
]
}
}
Example Response¶
{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
Returned Values¶
Error Codes¶
See Error Codes.