• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Nova
  5. Status Management
  6. Querying Operations on an ECS

Querying Operations on an ECS

Function

This API is used to query all historical operations 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 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

server_id

Yes

Specifies the ECS ID.

NOTE:

Pagination query is supported in microversion 2.58 and later. The query results are displayed by the creation time (created_at) of the records in descending order. If the creation time is not provided, the results are displayed by object ID in descending order. The number of records displayed on each page is limit. If the value of limit exceeds the maximum number configured by Nova, the maximum number configured by Nova is returned.

Request

Method

Mandatory

Description

limit

No

Specifies the upper limit on the number of returned results.

marker

No

Specifies that marker that points to the operation. The query starts from the next piece of data indexed by this parameter.

Response

Response parameters

Table 2 describes the response parameters.

Table 2 Response parameters

Parameter

Type

Mandatory

Description

action

String

Yes

Specifies the action.

Options:

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

instance_uuid

String

Yes

Specifies the ECS ID in UUID format.

message

String

Yes

Specifies the result status of the operation.

project_id

String

Yes

Specifies the project ID.

request_id

String

Yes

Specifies the request ID.

updated_at

String

Yes

Specifies the time when the information was updated.

start_time

String

Yes

Specifies the time when the action was started.

user_id

String

Yes

Specifies the user ID.

Examples

  • Example request
    GET /v2/89655fe61c4c4a08b9f3e7f9095441b8/servers/e723eb40-f56e-40f9-8c8c-caa517fe06ba/os-instance-actions
    GET /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 General Request Returned Values.