--- title: "Filter operations by attributes" method: GET path: "/v1/operations" tags: ["datasets"] --- # Filter operations by attributes `GET /v1/operations` List operations ## Query parameters - `limit` integer - `cursor_time` string, nullable — ISO 8601 timestamp used as the pagination cursor - `ai_project_id` string, nullable - `type` 'yql' | 'materialize_history' | 'batch_inference' | 'finetuning' | 'file_to_dataset' | 'dataset_to_file' | 'merge' ## Response `200` Successful Response - OperationsResponse - `object` string - `data` OperationResponse[], required - `uuid` string, uuid — A UUID string - `kind` 'image_import' | 'instance' — Type of the operation - `status` 'PENDING' | 'ASSIGNED' | 'EXECUTING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' - `error` string, nullable - `created_at` string — ISO 8601 formatted timestamp when the operation was created - `duration` number, nullable - `image_size` integer, nullable — Bytes written for the resulting image/layer(s). `null` when not measured (e.g. disposable instance, non-SUCCESS operations). - `consumed_cpu` number, nullable — CPU seconds (user_cpu_time + system_cpu_time) reported by the in-VM init. `null` when not measured. - `consumed_memory` integer, nullable — Peak memory (max_rss) reported by the in-VM init; units preserved as reported by getrusage. `null` when not measured. - `image_uuid` string, uuid — A UUID string - `result_image_uuid` string, uuid — A UUID string - `metadata` union — Metadata specific to the operation type - OperationInstanceMetadata — Metadata for an instance execution operation, including request parameters and result - `command` string, required — The command to execute. In case if `shell` is set to `true`, this MUST contain shell expression. For example `echo hello world` or `ls -l /app`. If `shell` is set to `false`, this must be a relative or absolute path to the executable inside the image rootfs. For example: `/bin/app` or `/usr/bin/find`. Do not forget pass necessary `PATH` variable to env field, by default `PATH` is set to `/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin`. - `disposable` boolean — Creates a disposable execution environment no any state will be saved. - `hostname` string — Hostname to set when execution. - `image` union, required — A UUID string - string, uuid — A UUID string - string, uuid — A container image tag. String must be started with a prefix "tag:" followed by the actual tag. - `args` string[] — Arguments to pass to the command if shell is set to false. - `shell` boolean — Whether to run the command through a shell. If `true`, the command must be a shell expression and all values from args will be ignored. If `false`, the command field must be a path to an executable and args will be used. When `true`, environment variables from the image are automatically inherited. When `false`, they are not - use the `env` field to pass them explicitly. - `env` object, nullable — Environment variables to set in the container. These are merged with image-defined variables when `shell` is `true`. When `shell` is `false`, only variables specified here are available - image-defined variables are not inherited. - `preserve_env` boolean — Preserve environment variables in resulting image after execution. When `true`, the image's existing environment variables from `metadata/env` are merged with user-provided `env` values (user values take priority on conflicts), and the combined result is written back to `metadata/env` after command execution. Setting a variable to an empty string or `null` removes it from the preserved environment. - `cwd` string — Path to the working directory, must be absolute or a special value the empty string. It means the default working directory of the image or server default will be used. If field is omitted it will be set to the empty string. The directory will be created automatically if it does not exist. - `uid` integer — User ID to run the process as. - `gid` integer — Group ID to run the process as. - `resources_limits` InstanceResourcesLimits - `max_layer_bytes` integer — Maximum writable layer size in bytes. - `networking` InstanceNetworking - `enabled` boolean — Enable network access for the instance. When `false`, the VM starts without a guest network interface. - `stdin` ClosableStreamRepr — Stdin payload. Unlike output streams it is never truncated; instead it carries a `close` flag controlling the pipe's EOF. - `value` string, required — Content to write to stdin (may be empty for a close-only request) - `encoding` 'ascii' | 'base64' — Encoding of the content - `close` boolean — `true` (default) closes stdin (EOF) after writing `value` — the pre-existing one-shot behavior. `false` keeps the pipe open so more data can be sent later via `POST /operations/{operationId}/subprocesses/{spid}/stdin`. - `timeout` integer — Maximum execution time in seconds - `truncate_output_at` integer — Maximum number of bytes to keep from stdout/stderr. Default is `1048576` (1 MiB). The maximum value is `10485760` (10 MiB). - `files` object — Map of absolute file paths to file metadata - `result` InstanceResult — Result of an instance execution - `resources` object - `block_input` integer — Block input operations - `block_output` integer — Block output operations - `cost` number, float — Operation cost - `elapsed_time` number — Elapsed wall time - `involuntary_switches` integer — Number of involuntary context switches - `max_rss` integer — Maximum resident set size in KB - `monotonic_time` number, float — Monotonic time measurement - `page_faults` integer — Number of page faults - `page_faults_io` integer — Number of page faults requiring I/O - `shared_memory` integer — Shared memory size - `signals` integer — Number of signals received - `swaps` integer — Number of swaps - `system_cpu_time` number, float — System CPU time used - `unshared_memory` integer — Unshared memory size - `user_cpu_time` number, float — User CPU time used - `voluntary_switches` integer — Number of voluntary context switches - `state` object - `continued` boolean — Whether the process was continued from a stop - `core_dump` boolean — Whether a core dump was generated - `exit_code` integer — Process exit code - `pid` integer — Process ID - `signal` integer — Signal that caused termination, if any - `stopped` boolean — Whether the process was stopped - `timed_out` boolean — Whether process had been killed because operation timeout was reached - `stdout` StreamRepr - `value` string, required — Content of the stream - `encoding` 'ascii' | 'base64', required — Encoding of the content - `truncated` boolean — Whether the output was truncated - `stderr` StreamRepr - `value` string, required — Content of the stream - `encoding` 'ascii' | 'base64', required — Encoding of the content - `truncated` boolean — Whether the output was truncated - ImageImportMetadata - `registry` object - `url` string — URL of the container registry - `credentials` object - `username` string — Username for the registry authentication - `password` string — Always masked in the response is present - `tag` string, nullable - `timeout` integer — Maximum time in seconds to wait for the import operation to complete - `result` object — Result of the operation, if any - `image` string, uuid — A UUID string - `tag` string, nullable — Tag assigned to the imported image ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/nebius/apis/nebius-openai-compatible-inference-api.md) · [All operations](https://skmtc.net/nebius/apis/nebius-openai-compatible-inference-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nebius/nebius-openai-compatible-inference-api/versions/0fb323abba3c/schema)