Help Center/Elastic Cloud Server/API Reference/Native OpenStack Nova APIs/ECS Operation Management/Listing Actions on an ECS
Updated on 2025-12-18 GMT+08:00
View PDF

Listing Actions on an ECS

Function

This API is used to list all historical actions on an ECS.

URI

GET /v2.1/{project_id}/servers/{server_id}/os-instance-actions

Table 1 describes the parameters in the URI.
Table 1 Path parameters

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.

Table 2 Query parameters

Parameter

Mandatory

Description

limit

No

Specifies the upper limit on the number of returned results.

This parameter is supported in microversion 2.58 and later.

marker

No

Specifies the marker that points to the server action. The query starts from the next piece of data indexed by this parameter. The value is request_id.

This parameter is supported in microversion 2.58 and later.

changes-since

No

Specifies a time to return the server actions happen after this time.

The format complies with ISO 8601 and is CCYY-MM-DDThh:mm:ss+/-hh:mm.

For example, set this parameter to 2018-01-17T03:03:32Z.

This parameter is supported in microversion 2.58 and later.

Request

None

Response

Table 3 describes the response parameters.

Table 3 Response parameters

Parameter

Type

Description

instanceActions

Array of Object

Specifies the list of actions performed on the ECS. For details, see Table 4.

Table 4 instanceActions field description

Parameter

Mandatory

Type

Description

action

Yes

String

Specifies the action.

Value range:

create, delete, evacuate, restore, stop, start, reboot, rebuild, revertResize, confirmResize, detach_volume, attach_volume, attach_interface, detach_interface, lock, unlock, resize, migrate, pause, unpause, rescue, unrescue, changePassword, shelve, unshelve, live-migration, trigger_crash_dump, extend_volume

instance_uuid

Yes

String

Specifies the ECS ID in UUID format.

message

Yes

String

Specifies the result status of the action.

project_id

Yes

String

Specifies the project ID.

request_id

Yes

String

Specifies the request ID.

start_time

Yes

String

Specifies the time when the action was started.

user_id

Yes

String

Specifies the user ID.

Example Request

List all historical actions on a specified ECS.

GET https://{endpoint}/v2.1/89655fe61c4c4a08b9f3e7f9095441b8/servers/e723eb40-f56e-40f9-8c8c-caa517fe06ba/os-instance-actions

Example Response

{
    "instanceActions": [
        {
            "instance_uuid": "e723eb40-f56e-40f9-8c8c-caa517fe06ba",
            "user_id": "752be40780484291a9cc7ae50fff3e6d",
            "start_time": "2014-12-16T10:58:14.000000",
            "request_id": "req-ee56c2b5-d33b-4749-ae83-09281dbbb716",
            "action": "resize",
            "message": "Error",
            "project_id": "89655fe61c4c4a08b9f3e7f9095441b8"
        },
        {
            "instance_uuid": "e723eb40-f56e-40f9-8c8c-caa517fe06ba",
            "user_id": "752be40780484291a9cc7ae50fff3e6d",
            "start_time": "2014-12-16T10:57:56.000000",
            "request_id": "req-23cfd57f-c58a-45cd-86a6-eab3e38f3753",
            "action": "resize",
            "message": "Error",
            "project_id": "89655fe61c4c4a08b9f3e7f9095441b8"
        },
    ]
}

Returned Values

See Returned Values for General Requests.