查看计算实例详情¶

读取一个计算实例的配置、容量和生命周期状态。

GET https://moi.matrixorigin.cn/newmoi/compute-resources/{resource_id}

调用前准备¶

先列出计算实例或创建计算实例，取得 resource_id。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和计算实例 ID。

请求参数¶

请求示例

curl "https://moi.matrixorigin.cn/newmoi/compute-resources/$RESOURCE_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数

字段	类型	必填	说明
`resource_id`	string	是	计算实例 ID。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "id": "cr-001",
    "name": "data-processing",
    "kind": "task",
    "spec_id": "task-standard-small",
    "status": "ACTIVE",
    "status_message": "",
    "min_replicas": 0,
    "max_replicas": 2,
    "current_replicas": 1,
    "allowed_actions": ["compute_resource.update", "compute_resource.operate"]
  }
}

字段说明

通用字段

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	object	响应数据。

计算实例

下面表格展开响应示例中 data 对象；每一行是该对象的一个字段。

字段	类型	说明
`id`	string	计算实例 ID。
`workspace_id`	string	所属工作区 ID。
`name`	string	计算实例名称。
`description`	string	实例说明；有值时返回。
`spec_id`	string	使用的计算规格 ID。
`kind`	string	实例类型。
`cpu`	integer	CPU 配置值。
`memory_gib`	integer	以内存 GiB 表示的配置值。
`gpu`	integer	GPU 配置值。
`cpu_milli`	integer	以毫核表示的 CPU 配置值。
`memory_mib`	integer	以内存 MiB 表示的配置值。
`gpu_count`	integer	GPU 数量。
`gpu_memory_mib`	integer	单个 GPU 的显存 MiB。
`gpu_cores`	integer	GPU 核心数。
`min_replicas`	integer	Serverless 实例固定为 `0`。
`max_replicas`	integer	最大副本数。
`desired_replicas`	integer	目标副本数。
`current_replicas`	integer	当前副本数。
`go_worker_image_id`	string	Go Worker 镜像 ID；有值时返回。
`python_worker_image_id`	string	Python Worker 镜像 ID；有值时返回。
`worker_images`	array of object	Worker 镜像选择；有值时返回。
`platform`	string	实例运行平台；有值时返回。
`auto_suspend_minutes`	integer	自动暂停等待时间。
`is_default`	boolean	是否为工作区默认计算实例。
`status`	string	生命周期状态，例如 `IDLE`、`ACTIVE`、`SUSPENDED` 或 `ERROR`。
`status_message`	string	状态的补充信息。
`scale_reason`	string	服务端提供的缩放原因；有值时返回。
`last_activation_at`	string	最近一次激活时间；有值时返回。
`last_active_at`	string	最近一次活跃时间；有值时返回。
`created_by`	string	创建者标识；有值时返回。
`created_at`	string	创建时间；有值时返回。
`updated_at`	string	最后更新时间；有值时返回。
`allowed_actions`	array of string	当前身份可对该计算实例执行的操作；为空时不应推断操作权限。

工作节点镜像

下面表格展开响应示例中 data.worker_images 数组的每一项；每一行是该数组项的一个字段。

字段	类型	说明
`worker_type`	string	Worker 类型。
`image_id`	string	镜像 ID。
`platform`	string	运行平台。

错误响应¶

响应示例

{
  "code": "NOT_FOUND",
  "msg": "对象不存在",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	错误说明。
`data`	null	错误时为空。

后续操作¶

根据 status 查询 Worker 运行时、更新计算实例或执行生命周期操作。

最后更新于 2026 年 9 月 3 日