• Elastic Cloud Server

ecs
  1. Help Center
  2. Elastic Cloud Server
  3. API Reference
  4. Extension ECS APIs
  5. Status Management
  6. Starting ECSs in a Batch

Starting ECSs in a Batch

Function

This interface is used to start ECSs in a batch based on the specified ECS ID list. A maximum of 1000 ECSs can be started at a time.

URI

POST /v1/{project_id}/cloudservers/action

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

Request

Request parameters

Table 2 describes the request parameters.
Table 2 Request parameters

Parameter

Mandatory

Type

Description

os-start

Yes

Dictionary data structure

Specifies the operation to start the ECS. For details, see Table 3.

Table 3 os-start field description

Parameter

Mandatory

Type

Description

servers

Yes

List data structure

Specifies ECS IDs. For details, see Table 4.

Table 4 servers field description

Parameter

Mandatory

Type

Description

id

Yes

String

Specifies the ECS ID.

Response

See Responses (Task).

Examples

  • Example request
    NOTE:

    In the request, the parameters to start ECSs must be sent with field os-start. For details, see the example request.

    {
        "os-start": {
            "servers": [
                {
                    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
                },
                {
                    "id": "726fb98f-46ca-475e-917e-2563e5a8cd20"
                }
            ]
        }
    }

Returned Values

See General Request Returned Values.

Error Code

See Error Code Description.