<span id="计算管理运行与生命周期公共对象"></span>

# 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. |

<span id="当前实际填充范围"></span>

## 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.
