# 查询计算资源管理运行状态

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

读取目标实例的Worker类型、状态与副本记录，不将它们合并为父实例状态。

```text
GET https://api.moi.matrixorigin.cn/v5/admin/compute-resources/{id}/runtime
```

## 调用前准备

准备当前部署有效身份、已配置的计算规格管理员资格和可访问的鉴权工作区。工作区Owner或Genesis管理scope不能替代。将示例ID替换为获准读取或操作的目标，详见[计算实例](../../../../../developer/cli/tasks/compute-resources.md)。

无分页或Worker类型筛选参数。资源不存在与存在但runtimes为空分开；这是存储中的运行投影，不保证与外部Pod、进程或服务就绪时间同步。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X GET "https://api.moi.matrixorigin.cn/v5/admin/compute-resources/cr-example/runtime" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $AUTH_WORKSPACE_ID"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `X-API-Key` | string | 示例是 | 有效个人访问令牌，须对应当前部署已配置的计算规格管理员。 |
| `X-Workspace-ID` | string | 是 | 唯一非空鉴权工作区，当前主体需有相应访问；不是目标实例工作区筛选。 |
| `id` | string | 是 | 目标实例ID，服务按该ID解析实际所属工作区。 |

本接口不读取业务请求体；不通过body提交目标工作区或状态。
:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "runtimes": [
      {
        "compute_resource_id": "cr-example",
        "worker_type": "python-worker",
        "status": "IDLE",
        "desired_replicas": 0,
        "current_replicas": 0,
        "created_at": "2026-11-12T07:00:00Z",
        "updated_at": "2026-11-12T07:00:00Z"
      }
    ]
  }
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 成功为OK。 |
| `msg` | string | 成功为OK。 |
| `data` | object | 当前读取或操作后的数据。 |
| `data.runtimes` | object（对象数组） | 按Worker类型返回；已确认父资源存在但无记录时为[]，不表示可调用。 |
| `data.runtimes[].compute_resource_id` | string | 关联父计算实例ID。 |
| `data.runtimes[].worker_type` | string | Worker类型标识，不将任意类型简化成Go/Python二选一。 |
| `data.runtimes[].status` | string | 该Worker类型记录的生命周期状态，与父实例状态分别回查。 |
| `data.runtimes[].desired_replicas` | integer | 该Worker类型的目标副本字段。 |
| `data.runtimes[].current_replicas` | integer | 该Worker类型的当前副本字段。 |
| `data.runtimes[].last_activation_at` | string，可省略 | 最近激活时间，RFC3339，未记录时省略。 |
| `data.runtimes[].last_active_at` | string，可省略 | 最近活跃时间，RFC3339，未记录时省略。 |
| `data.runtimes[].created_at` | string | 创建时间，RFC3339。 |
| `data.runtimes[].updated_at` | string | 更新时间，RFC3339；不是调用者可提交的并发版本。 |

嵌套镜像、声明观测对象和父/Worker状态关系见[公共对象](compute-runtime-admin-objects.md)。
:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{"code":"INVALID_PARAMS","msg":"invalid compute resource request","data":null}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 按失败阶段与动作区分。 |
| `msg` | string | 错误文本；部分分支本地化，不回显未分类底层错误。 |
| `data` | null | 本示例为null；共享鉴权错误分支可能省略。 |

| HTTP / code | 条件与处理 |
| --- | --- |
| 400 / INVALID_PARAMS | 缺少鉴权工作区、主体或资源ID。 |
| 403 / ErrForbidden | 权限检查边界拒绝管理员事实、当前主体或工作区访问。 |
| 503 / ErrServiceUnavailable | 已分类的共享授权不可用，不推广到所有目录失败。 |
| 404 / NOT_FOUND | 父资源不存在或不在当前可读取集合。 |
| 500 / ErrServer | 未专门分类的目录、存储或内部失败。 |

不同handler、身份和恢复阶段见[错误与恢复](compute-runtime-admin-errors-recovery.md)。
:::::
::::::
:::::::
