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记录

字段

类型

说明

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为准。

最后更新于