查看计算实例列表¶

列出当前工作区中调用者有读取权限的计算实例。

GET https://api.moi.matrixorigin.cn/v5/compute-resources

调用前准备¶

准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求参数¶

请求示例

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

参数说明

参数

此请求不包含路径参数、查询参数或请求体。

成功响应¶

响应示例

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

字段说明

通用字段

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	array of 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	目标副本数。
`status`	string	当前生命周期状态。
`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_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": "LIST_FAILED",
  "msg": "服务端错误",
  "data": null
}

字段说明

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

后续操作¶

保存 data[].id，再查询计算实例详情或创建计算实例。

最后更新于 2026 年 9 月 11 日