Compute administration runtime and lifecycle common objects

Fields follow the current handler DTOs and converters. Unlike administrative lists, the three lifecycle APIs use the regular computeResourceDTO, including allowed_actions without adding workspace.

computeResourceDTO

Field

Type

Description

id

string

Compute instance ID.

workspace_id

string

The workspace that owns the instance, separate from the authentication header.

name

string

Instance name.

description

string

Instance description; may be an empty string.

kind

string

task or query.

spec_id

string

Associated specification ID.

cpu

integer

Legacy CPU specification in cores; do not confuse it with cpu_milli.

memory_gib

integer

Legacy memory specification in GiB.

gpu

integer

Legacy GPU specification.

cpu_milli

integer

CPU specification in millicores.

memory_mib

integer

Memory specification in MiB.

gpu_count

integer

Number of GPUs in the specification.

gpu_memory_mib

integer

GPU memory specification in MiB.

gpu_cores

integer

GPU core specification.

min_replicas

integer

Configured minimum replicas, distinct from currently observed replicas.

max_replicas

integer

Replica limit per Worker type, not a combined limit across all types.

current_replicas

integer

Current aggregate instance replica count, separate from observations by type.

desired_replicas

integer

Target instance replica count; does not indicate readiness.

go_worker_image_id

string

Legacy Go Worker image ID; may be empty.

python_worker_image_id

string

Legacy Python Worker image ID; may be empty.

worker_images

object (array of objects), optional

Images selected by Worker type; may be omitted. See the item fields below.

platform

string

Worker platform configuration.

auto_suspend_minutes

integer

Auto-suspension setting in minutes, not a completion-time guarantee for this operation.

scale_reason

string

Most recent scaling or lifecycle reason.

is_default

boolean

Whether this is the default instance; may be false.

status

string

Parent instance state. The current model includes IDLE, DEPLOYING, SCALING, ACTIVE, DRAINING, SUSPENDED, TERMINATING, and ERROR. Keep this separate from Worker states.

status_message

string

Status text; may be empty.

py_requirements_txt

string, optional

Optional saved Python dependency text; may be returned when nonempty. Not declared in the current typed SDK model.

py_requirements_sha

string, optional

Optional saved dependency content hash; not declared in the current typed SDK model.

py_deps

object, optional

Optional observation object declared by the DTO, but not populated by the converters for these three lifecycle APIs. Do not rely on it for installation progress.

created_by

string

Creating principal.

allowed_actions

string (array of strings)

Allowed-action projection. These three lifecycle APIs do not construct actions separately; an empty array does not determine administrator eligibility.

last_activation_at

string, optional

Last activation time in RFC3339; omitted if not recorded.

last_active_at

string, optional

Last activity time in RFC3339; omitted if not recorded.

created_at

string

Creation time in RFC3339.

updated_at

string

Update time in RFC3339; not a caller-supplied concurrency version.

computeResourceWorkerImageDTO

Field

Type

Description

worker_type

string, optional

Worker type identifier. Do not reduce arbitrary types to a Go/Python choice.

kind

string, optional

Optional legacy Worker type alias; prefer worker_type.

image_id

string

Image ID.

platform

string

Worker platform configuration.

computeResourcePyDepsDTO

Field

Type

Description

status

string

Declared aggregate dependency state: EMPTY, INSTALLING, READY, or FAILED; not currently populated by these APIs.

ready_count

integer

Declared number of instances with dependencies ready. These three lifecycle APIs do not populate the object.

total_count

integer

Declared total number of instances observed for dependencies.

last_error

string, optional

Optional dependency error; not populated by these three lifecycle APIs.

computeResourceWorkerRuntimeDTO

Field

Type

Description

compute_resource_id

string

Associated parent compute instance ID.

worker_type

string

Worker type identifier. Do not reduce arbitrary types to a Go/Python choice.

status

string

Lifecycle state recorded for this Worker type. Check it separately from the parent instance state.

desired_replicas

integer

Target replica count for this Worker type.

current_replicas

integer

Current replica count for this Worker type.

last_activation_at

string, optional

Last activation time in RFC3339; omitted if not recorded.

last_active_at

string, optional

Last activity time in RFC3339; omitted if not recorded.

created_at

string

Creation time in RFC3339.

updated_at

string

Update time in RFC3339; not a caller-supplied concurrency version.

Fields currently populated

computeResourceDTO declares py_deps, but computeResourceToDTO does not currently assign it. The three lifecycle APIs do not additionally read dependency aggregates, so this object is absent from current success examples. A field declaration does not prove these paths return observations. Its absence does not indicate that dependencies are disabled or installation is complete.

py_requirements_txt/sha are converted and returned when saved values are nonempty; otherwise omitempty removes them. Empty worker_images is omitted. Even nil allowed_actions becomes []. Missing optional activity timestamps are omitted. Current HTTP objects and typed SDKs expose different field sets; see the client page for compatibility.

max_replicas applies to each Worker type. Check parent desired/current fields and runtime fields by type separately. A single number does not guarantee everything is ready. GET runtime currently has no pagination or single-type filter and does not report a last probe time or prove external Pod health.

Last updated on