查询计算资源管理运行状态¶
读取目标实例的Worker类型、状态与副本记录,不将它们合并为父实例状态。
GET https://api.moi.matrixorigin.cn/v5/admin/compute-resources/{id}/runtime
调用前准备¶
准备当前部署有效身份、已配置的计算规格管理员资格和可访问的鉴权工作区。工作区Owner或Genesis管理scope不能替代。将示例ID替换为获准读取或操作的目标,详见计算实例。
无分页或Worker类型筛选参数。资源不存在与存在但runtimes为空分开;这是存储中的运行投影,不保证与外部Pod、进程或服务就绪时间同步。
请求参数¶
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"
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
示例是 |
有效个人访问令牌,须对应当前部署已配置的计算规格管理员。 |
|
string |
是 |
唯一非空鉴权工作区,当前主体需有相应访问;不是目标实例工作区筛选。 |
|
string |
是 |
目标实例ID,服务按该ID解析实际所属工作区。 |
本接口不读取业务请求体;不通过body提交目标工作区或状态。
成功响应¶
{
"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"
}
]
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
成功为OK。 |
|
string |
成功为OK。 |
|
object |
当前读取或操作后的数据。 |
|
object(对象数组) |
按Worker类型返回;已确认父资源存在但无记录时为[],不表示可调用。 |
|
string |
关联父计算实例ID。 |
|
string |
Worker类型标识,不将任意类型简化成Go/Python二选一。 |
|
string |
该Worker类型记录的生命周期状态,与父实例状态分别回查。 |
|
integer |
该Worker类型的目标副本字段。 |
|
integer |
该Worker类型的当前副本字段。 |
|
string,可省略 |
最近激活时间,RFC3339,未记录时省略。 |
|
string,可省略 |
最近活跃时间,RFC3339,未记录时省略。 |
|
string |
创建时间,RFC3339。 |
|
string |
更新时间,RFC3339;不是调用者可提交的并发版本。 |
嵌套镜像、声明观测对象和父/Worker状态关系见公共对象。
错误响应¶
{"code":"INVALID_PARAMS","msg":"invalid compute resource request","data":null}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
按失败阶段与动作区分。 |
|
string |
错误文本;部分分支本地化,不回显未分类底层错误。 |
|
null |
本示例为null;共享鉴权错误分支可能省略。 |
HTTP / code |
条件与处理 |
|---|---|
400 / INVALID_PARAMS |
缺少鉴权工作区、主体或资源ID。 |
403 / ErrForbidden |
权限检查边界拒绝管理员事实、当前主体或工作区访问。 |
503 / ErrServiceUnavailable |
已分类的共享授权不可用,不推广到所有目录失败。 |
404 / NOT_FOUND |
父资源不存在或不在当前可读取集合。 |
500 / ErrServer |
未专门分类的目录、存储或内部失败。 |
不同handler、身份和恢复阶段见错误与恢复。