Runner与计算观测对象¶
这些接口区分产品身份管理、连接状态、Edge持有者续期和计算实例依赖观测。示例值不代表部署默认值。
调用前准备¶
使用同环境的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互相替换。
Runner记录¶
字段 |
类型 |
说明 |
|---|---|---|
|
string |
稳定Runner ID。 |
|
string |
所属工作区。 |
|
string |
注册用户ID,不等于当前调用者的权限范围。 |
|
string |
注册名称。 |
|
string |
本组创建为custom。 |
|
string |
Edge注册标识,当前为runner-加Runner ID。 |
|
string |
创建、受支持的同请求重放或显式刷新返回;普通列表/详情省略。含连接凭据。 |
|
string |
持久记录阶段,pending或ready;不代表实时连接或执行准入。 |
|
string |
token到期时间,未设置时省略。 |
|
string |
RFC3339时间。 |
列表data直接为数组,不使用items/total。JTI、内部生命周期、Principal/Role及恢复请求信息不在公开记录JSON中。
执行器健康¶
字段 |
类型 |
说明 |
|---|---|---|
|
array(对象数组) |
当前可读Runner与启用的Sandbox。 |
|
boolean |
有可见对象时是否成功取得Astra连接状态;空集合不实际探测。 |
|
string |
对象ID与名称。 |
|
string |
runner或sandbox。 |
|
string |
对应对象持久阶段。 |
|
string |
用于匹配连接状态的Edge ID。 |
|
boolean |
是否在取得的连接状态集合中。 |
|
integer |
连接持续秒数,未连接时省略;连接恰为0秒时仍可返回0。 |
|
boolean |
当前投影随连接命中设为true,不是任务、工具或权限探测。 |
Python依赖观测¶
Worker字段 |
类型 |
说明 |
|---|---|---|
|
string |
已观测的实例ID。 |
|
string |
Worker类型。 |
|
string |
当前持久实例状态;本查询仅保留STARTING/READY/STOPPING。 |
|
string |
依赖内容SHA,须匹配当前计算实例配置;空时省略。 |
|
string |
EMPTY/INSTALLING/READY/FAILED,空时省略。 |
|
string |
最近安装错误摘要,空时省略。 |
此列表仅保留cloud实例、有依赖SHA且匹配当前期望SHA的记录,排除旧配置和终态实例。它不是所有历史、Docker或本地Worker列表,也不同于/runtime按Worker类型返回的副本汇总。无分页或总数包装。
Python依赖限制¶
字段 |
类型 |
说明 |
|---|---|---|
|
boolean |
当前部署是否启用依赖功能。 |
|
integer |
依赖文本大小限制,单位字节。 |
|
integer |
依赖文本行数限制。 |
|
array(字符串数组)或null |
当前允许的索引域名列表;nil序列化可为null。 |
|
string |
部署pip索引地址,空时省略。 |
|
integer |
安装超时,单位秒。 |
读取的是动态配置,不保证等于源码初始值。trusted host、尾日志行数及PV限制不是本DTO字段。enabled=false与加载不可用分别处理,不把503解释为已明确关闭。
Edge续期回执¶
数值code=0,data含token和expires_at;expires_at为RFC3339。返回新token前,服务在同一系统事务检查当前JTI、验证旧凭据、吊销旧凭据并替换绑定。有效期使用当前注册签发策略,所查源码为30天;以实际expires_at为准。