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

读取目标实例的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"

参数

类型

是否必填

说明

X-API-Key

string

示例是

有效个人访问令牌,须对应当前部署已配置的计算规格管理员。

X-Workspace-ID

string

是

唯一非空鉴权工作区,当前主体需有相应访问;不是目标实例工作区筛选。

id

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"
      }
    ]
  }
}

字段

类型

说明

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状态关系见公共对象。

错误响应

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

字段

类型

说明

code

string

按失败阶段与动作区分。

msg

string

错误文本;部分分支本地化,不回显未分类底层错误。

data

null

本示例为null;共享鉴权错误分支可能省略。

HTTP / code

条件与处理

400 / INVALID_PARAMS

缺少鉴权工作区、主体或资源ID。

403 / ErrForbidden

权限检查边界拒绝管理员事实、当前主体或工作区访问。

503 / ErrServiceUnavailable

已分类的共享授权不可用,不推广到所有目录失败。

404 / NOT_FOUND

父资源不存在或不在当前可读取集合。

500 / ErrServer

未专门分类的目录、存储或内部失败。

不同handler、身份和恢复阶段见错误与恢复。

最后更新于