更新计算实例¶

更新当前工作区中一个计算实例的可修改配置。Serverless 实例不会因配置更新立即部署 Worker；Worker 按后续工作负载需求激活。

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

调用前准备¶

先查询计算实例详情，确认要更新的实例。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和计算实例 ID。

请求体¶

请求示例

curl -X PUT "https://moi.matrixorigin.cn/newmoi/compute-resources/$RESOURCE_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "description": "updated",
    "max_replicas": 3,
    "auto_suspend_minutes": 30
  }'

参数说明

路径参数

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

请求体

字段	类型	必填	说明
`name`	string	否	实例名称。
`description`	string	否	实例说明。
`kind`	string	否	兼容性提示。
`spec_id`	string	否	计算规格 ID。
`cpu`	integer	否	CPU 配置。
`memory_gib`	integer	否	内存 GiB 配置。
`gpu`	integer	否	GPU 配置。
`min_replicas`	integer	否	仅接受 `0`。
`max_replicas`	integer	否	副本上限，必须大于 `0`。
`auto_suspend_minutes`	integer	否	自动暂停等待时间。
`worker_images`	array of object	否	Worker 镜像选择。提交此字段时必须用完整列表替换原配置，并覆盖当前所有活跃的 `worker_type`。
`go_worker_image_id`	string	否	兼容的 Go Worker 镜像 ID。
`python_worker_image_id`	string	否	兼容的 Python Worker 镜像 ID。
`platform`	string	否	兼容的运行平台。

字段路径中的 [] 表示数组中的每一项。例如，worker_images[].worker_type 表示 worker_images 数组中每一项的 worker_type 字段。

只提交要修改的字段。

worker_images 项

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

字段	类型	必填	说明
`worker_type`	string	否	Worker 类型。
`kind`	string	否	兼容别名；传入时应与 `worker_type` 一致。
`image_id`	string	否	镜像 ID。
`platform`	string	否	镜像运行平台。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "id": "cr-001",
    "name": "data-processing",
    "description": "updated",
    "spec_id": "task-standard-small",
    "status": "IDLE",
    "status_message": "",
    "min_replicas": 0,
    "max_replicas": 3,
    "current_replicas": 0
  }
}

字段说明

通用字段

字段	类型	说明
`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	更新后的当前生命周期状态。
`status_message`	string	状态补充信息；有值时返回。
`scale_reason`	string	服务端提供的缩放原因；有值时返回。
`last_activation_at`	string	最近一次激活时间；有值时返回。
`last_active_at`	string	最近一次活跃时间；有值时返回。
`created_by`	string	创建者标识；有值时返回。
`created_at`	string	创建时间；有值时返回。
`updated_at`	string	最后更新时间；有值时返回。

工作节点镜像

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

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

错误响应¶

响应示例

{
  "code": "UPDATE_FAILED",
  "msg": "服务器内部错误",
  "data": null
}

字段说明

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

后续操作¶

查询计算实例详情或查询 Worker 运行时确认变更进度。

最后更新于 2026 年 9 月 3 日