Get an operation status

Error

A valid request URL is required to generate request examples

{
  "uuid": "12345678-9abc-baba-deda-0123456789ab",
  "error": "<string>",
  "created_at": "2024-01-01T12:00:00+00:00",
  "duration": 123,
  "image_size": 123,
  "consumed_cpu": 123,
  "consumed_memory": 123,
  "image_uuid": "12345678-9abc-baba-deda-0123456789ab",
  "result_image_uuid": "12345678-9abc-baba-deda-0123456789ab",
  "metadata": {
    "command": "/bin/app",
    "image": "12345678-9abc-baba-deda-0123456789ab",
    "disposable": false,
    "hostname": "container-name",
    "args": [
      "arg1",
      "arg2"
    ],
    "shell": false,
    "env": {
      "KEY1": "value1",
      "KEY2": "value2"
    },
    "preserve_env": false,
    "cwd": "/app",
    "uid": 0,
    "gid": 0,
    "resources_limits": {
      "max_layer_bytes": 1073741824
    },
    "stdin": {
      "value": "Y29tbWFuZCBvdXRwdXQK",
      "encoding": "base64",
      "truncated": false
    },
    "timeout": 60,
    "truncate_output_at": 65535,
    "files": {
      "/root/hello.txt": {
        "uuid": "a9165a5d-5c86-4bd8-8ee4-ae46c19cf45d",
        "uid": 0,
        "gid": 0,
        "mode": "0644"
      },
      "/tmp/log.txt": {
        "uuid": "065def2a-e977-4852-8b26-a0ec05e85a90",
        "uid": 1000,
        "gid": 1000,
        "mode": "0600"
      }
    },
    "result": {
      "resources": {
        "block_input": 123,
        "block_output": 123,
        "cost": 123,
        "elapsed_time": 123,
        "involuntary_switches": 123,
        "max_rss": 123,
        "monotonic_time": 123,
        "page_faults": 123,
        "page_faults_io": 123,
        "shared_memory": 123,
        "signals": 123,
        "swaps": 123,
        "system_cpu_time": 123,
        "unshared_memory": 123,
        "user_cpu_time": 123,
        "voluntary_switches": 123
      },
      "state": {
        "continued": true,
        "core_dump": true,
        "exit_code": 123,
        "pid": 123,
        "signal": 123,
        "stopped": true,
        "timed_out": true
      },
      "stdout": {
        "value": "Y29tbWFuZCBvdXRwdXQK",
        "encoding": "base64",
        "truncated": false
      },
      "stderr": {
        "value": "Y29tbWFuZCBvdXRwdXQK",
        "encoding": "base64",
        "truncated": false
      }
    }
  },
  "result": {
    "image": "12345678-9abc-baba-deda-0123456789ab",
    "tag": "busybox:latest"
  }
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

GET

operations

{operationId}

Error

A valid request URL is required to generate request examples

{
  "uuid": "12345678-9abc-baba-deda-0123456789ab",
  "error": "<string>",
  "created_at": "2024-01-01T12:00:00+00:00",
  "duration": 123,
  "image_size": 123,
  "consumed_cpu": 123,
  "consumed_memory": 123,
  "image_uuid": "12345678-9abc-baba-deda-0123456789ab",
  "result_image_uuid": "12345678-9abc-baba-deda-0123456789ab",
  "metadata": {
    "command": "/bin/app",
    "image": "12345678-9abc-baba-deda-0123456789ab",
    "disposable": false,
    "hostname": "container-name",
    "args": [
      "arg1",
      "arg2"
    ],
    "shell": false,
    "env": {
      "KEY1": "value1",
      "KEY2": "value2"
    },
    "preserve_env": false,
    "cwd": "/app",
    "uid": 0,
    "gid": 0,
    "resources_limits": {
      "max_layer_bytes": 1073741824
    },
    "stdin": {
      "value": "Y29tbWFuZCBvdXRwdXQK",
      "encoding": "base64",
      "truncated": false
    },
    "timeout": 60,
    "truncate_output_at": 65535,
    "files": {
      "/root/hello.txt": {
        "uuid": "a9165a5d-5c86-4bd8-8ee4-ae46c19cf45d",
        "uid": 0,
        "gid": 0,
        "mode": "0644"
      },
      "/tmp/log.txt": {
        "uuid": "065def2a-e977-4852-8b26-a0ec05e85a90",
        "uid": 1000,
        "gid": 1000,
        "mode": "0600"
      }
    },
    "result": {
      "resources": {
        "block_input": 123,
        "block_output": 123,
        "cost": 123,
        "elapsed_time": 123,
        "involuntary_switches": 123,
        "max_rss": 123,
        "monotonic_time": 123,
        "page_faults": 123,
        "page_faults_io": 123,
        "shared_memory": 123,
        "signals": 123,
        "swaps": 123,
        "system_cpu_time": 123,
        "unshared_memory": 123,
        "user_cpu_time": 123,
        "voluntary_switches": 123
      },
      "state": {
        "continued": true,
        "core_dump": true,
        "exit_code": 123,
        "pid": 123,
        "signal": 123,
        "stopped": true,
        "timed_out": true
      },
      "stdout": {
        "value": "Y29tbWFuZCBvdXRwdXQK",
        "encoding": "base64",
        "truncated": false
      },
      "stderr": {
        "value": "Y29tbWFuZCBvdXRwdXQK",
        "encoding": "base64",
        "truncated": false
      }
    }
  },
  "result": {
    "image": "12345678-9abc-baba-deda-0123456789ab",
    "tag": "busybox:latest"
  }
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

IAM bearer token issued by the Nebius IAM service. Sent as Authorization: Bearer <iam-token>. Must be combined with the Project header (see IAMProjectHeader).

This is the recommended authentication scheme for new clients.

Project

string

header

required

Nebius project ID associated with the IAM token. Required together with IAMBearerAuth. Identifies the project context the request is scoped to.

Path Parameters

operationId

string<uuid>

required

The ID of the operation A UUID string

Example:

"12345678-9abc-baba-deda-0123456789ab"

Query Parameters

inflight

enum<string>

default:0

HTTP-flag boolean. Present without a value (?inflight) and ?inflight=1 both enable; ?inflight=0 and absence disable. When enabled and the operation is EXECUTING INSTANCE, partial stdout/stderr is synthesized from the live event log and attached under result.

Available options:

0,

1

Response

uuid

string<uuid>

A UUID string

Example:

"12345678-9abc-baba-deda-0123456789ab"

kind

enum<string>

Type of the operation

Available options:

image_import,

instance

status

enum<string>

Available options:

PENDING,

ASSIGNED,

EXECUTING,

SUCCESS,

FAILED,

CANCELLED

error

string | null

created_at

string

ISO 8601 formatted timestamp when the operation was created

Example:

"2024-01-01T12:00:00+00:00"

duration

number | null

image_size

integer | null

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

consumed_cpu

number | null

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

consumed_memory

integer | null

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

image_uuid

string<uuid> | null

UUID of the source image this operation was run on. Set for INSTANCE operations, null for IMAGE_IMPORT.

Example:

"12345678-9abc-baba-deda-0123456789ab"

result_image_uuid

string<uuid> | null

UUID of the image produced by this operation. Only set for completed (SUCCESS) operations, null otherwise.

Example:

"12345678-9abc-baba-deda-0123456789ab"

metadata

object

Metadata specific to the operation type

Option 1
Option 2

Show child attributes

result

object

Result of the operation, if any

Show child attributes

List operations Cancel an operation

⌘I

API Documentation

Inference and Training

Sandboxes

Authorizations

Path Parameters

Query Parameters

Response