Sign in

v1

latestOpenAPI 3.1.02026-07-2675394318.9 KB
operations

List operations

Returns a list of running and completed operations

get/operations

Query parameters

limitinteger

Maximum number of operations to return. Must be between 1 and 1000. Default is 100. Invalid values raise 400 error.

offsetinteger

Number of operations to skip before starting to collect the result set. Default is 0. Invalid values raise 400 error.

status'PENDING' | 'EXECUTING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'ASSIGNED'

Filter operations by their state

kind'image_import' | 'instance'

Filter operations by their kind

sincestring

Show only results created after the given date/time or interval.

Accepts a Unix timestamp or interval string.

Interval format: 600s/15m/2h/3d/1w means 600 seconds, 15 minutes, 2 hours, 3 day, or 1 week ago respectively).

For example:

  • 2025-01-01T12:00:00+00:00 means January 1st, 2025 at 12:00 UTC
  • 600s means 600 seconds ago
  • 15m means 15 minutes ago

Invalid values raise 400 error.

untilstring

Show only results created before the given date/time or interval.

Accepts a Unix timestamp or interval string.

Interval format: 600s/15m/2h/3d/1w means 600 seconds, 15 minutes, 2 hours, 3 day, or 1 week ago respectively).

For example:

  • 2025-01-01T12:00:00+00:00 means January 1st, 2025 at 12:00 UTC
  • 600s means 600 seconds ago
  • 15m means 15 minutes ago

Invalid values raise 400 error.

Response

OK

uuidstring uuid

A UUID string

kind'image_import' | 'instance'

Type of the operation

status'PENDING' | 'ASSIGNED' | 'EXECUTING' | 'SUCCESS' | 'FAILED' | 'CANCELLED'

Current state of the instance operation

errorstring nullable

Error message if the operation failed

created_atstring

ISO 8601 formatted timestamp when the operation was created

durationnumber nullable

Operation duration in seconds

image_sizeinteger nullable

Bytes written for the resulting image/layer(s). null when not measured (e.g. disposable instance, non-SUCCESS operations).

consumed_cpunumber nullable

CPU seconds (user_cpu_time + system_cpu_time) reported by the in-VM init. null when not measured.

consumed_memoryinteger nullable

Peak memory (max_rss) reported by the in-VM init; units preserved as reported by getrusage. null when not measured.

image_uuidstring uuid

A UUID string

result_image_uuidstring uuid

A UUID string

Example response

[
  {
    "uuid": "12345678-9abc-baba-deda-0123456789ab",
    "status": "success",
    "error": "Container image not found",
    "created_at": "2024-01-01T12:00:00+00:00",
    "image_uuid": "12345678-9abc-baba-deda-0123456789ab",
    "result_image_uuid": "12345678-9abc-baba-deda-0123456789ab"
  }
]