# Runner与计算观测对象

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

这些接口区分产品身份管理、连接状态、Edge持有者续期和计算实例依赖观测。示例值不代表部署默认值。

<span id="prepare"></span>

## 调用前准备

使用同环境的BASE_URL、产品个人访问令牌MOI_KEY和WORKSPACE_ID。BASE_URL已包含产品前缀；Runner与计算观测路径均没有/workspaces/{id}段，工作区在X-Workspace-ID中传递。

RUNNER_ID来自创建或列表，RESOURCE_ID来自计算实例列表。创建Runner时REQUEST_ID标识同一次注册操作，恢复时保留原值；名称不同的注册任务使用新值。正式边界仍核实当前Principal、Effective Role及请求关联信息。

Edge续期只在JSON中携带当前EDGE_TOKEN，无需产品PAT或工作区头。这个token只能续期登记的Edge身份，不产生产品资源访问或任务执行授权。不要把check、renew、注册、RuntimeGrant和Web应用session互相替换。

<span id="responses"></span>

## Runner记录

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `id` | string | 稳定Runner ID。 |
| `workspace_id` | string | 所属工作区。 |
| `user_id` | string | 注册用户ID，不等于当前调用者的权限范围。 |
| `name` | string | 注册名称。 |
| `runner_type` | string | 本组创建为custom。 |
| `edge_agent_id` | string | Edge注册标识，当前为runner-加Runner ID。 |
| `connect_cmd` | string | 创建、受支持的同请求重放或显式刷新返回；普通列表/详情省略。含连接凭据。 |
| `phase` | string | 持久记录阶段，pending或ready；不代表实时连接或执行准入。 |
| `token_expires_at` | string | token到期时间，未设置时省略。 |
| `created_at`、`updated_at` | string | RFC3339时间。 |

列表data直接为数组，不使用items/total。JTI、内部生命周期、Principal/Role及恢复请求信息不在公开记录JSON中。

## 执行器健康

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `executors` | array（对象数组） | 当前可读Runner与启用的Sandbox。 |
| `astra_reachable` | boolean | 有可见对象时是否成功取得Astra连接状态；空集合不实际探测。 |
| `executors[].id`、`executors[].name` | string | 对象ID与名称。 |
| `executors[].type` | string | runner或sandbox。 |
| `executors[].phase` | string | 对应对象持久阶段。 |
| `executors[].edge_agent_id` | string | 用于匹配连接状态的Edge ID。 |
| `executors[].connected` | boolean | 是否在取得的连接状态集合中。 |
| `executors[].connected_secs` | integer | 连接持续秒数，未连接时省略；连接恰为0秒时仍可返回0。 |
| `executors[].ready` | boolean | 当前投影随连接命中设为true，不是任务、工具或权限探测。 |

## Python依赖观测

| Worker字段 | 类型 | 说明 |
| --- | --- | --- |
| `instance_id` | string | 已观测的实例ID。 |
| `worker_type` | string | Worker类型。 |
| `status` | string | 当前持久实例状态；本查询仅保留STARTING/READY/STOPPING。 |
| `py_requirements_sha` | string | 依赖内容SHA，须匹配当前计算实例配置；空时省略。 |
| `py_requirements_status` | string | EMPTY/INSTALLING/READY/FAILED，空时省略。 |
| `py_requirements_error` | string | 最近安装错误摘要，空时省略。 |

此列表仅保留cloud实例、有依赖SHA且匹配当前期望SHA的记录，排除旧配置和终态实例。它不是所有历史、Docker或本地Worker列表，也不同于/runtime按Worker类型返回的副本汇总。无分页或总数包装。

## Python依赖限制

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `enabled` | boolean | 当前部署是否启用依赖功能。 |
| `max_bytes` | integer | 依赖文本大小限制，单位字节。 |
| `max_lines` | integer | 依赖文本行数限制。 |
| `allowed_index_hosts` | array（字符串数组）或null | 当前允许的索引域名列表；nil序列化可为null。 |
| `pip_index_url` | string | 部署pip索引地址，空时省略。 |
| `install_timeout_seconds` | integer | 安装超时，单位秒。 |

读取的是动态配置，不保证等于源码初始值。trusted host、尾日志行数及PV限制不是本DTO字段。enabled=false与加载不可用分别处理，不把503解释为已明确关闭。

## Edge续期回执

数值code=0，data含token和expires_at；expires_at为RFC3339。返回新token前，服务在同一系统事务检查当前JTI、验证旧凭据、吊销旧凭据并替换绑定。有效期使用当前注册签发策略，所查源码为30天；以实际expires_at为准。
