# 恢复计算资源

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

以配置管理员身份恢复目标计算实例，返回操作后重新读取的实例对象。

```text
POST https://api.moi.matrixorigin.cn/v5/admin/compute-resources/{id}/resume
```

## 调用前准备

准备当前部署有效身份、已配置的计算规格管理员资格和可访问的鉴权工作区。工作区Owner或Genesis管理scope不能替代。将示例ID替换为获准读取或操作的目标，详见[计算实例](../../../../../developer/cli/tasks/compute-resources.md)。

先确认父实例为SUSPENDED。通过预期旧状态CAS把父实例目标状态重置为IDLE，再独立回读；不在此调用中启动Worker。并发操作可能改变回读结果，按返回和后续运行状态核对。 当前三端typed计算资源模型未声明非空py_requirements_txt/sha返回字段；自定义依赖实例的兼容性需单独确认。使用原始HTTP保留状态和响应，客户端解码报错后先回查，不能推断操作未发生。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X POST "https://api.moi.matrixorigin.cn/v5/admin/compute-resources/cr-example/resume" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $AUTH_WORKSPACE_ID"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `X-API-Key` | string | 示例是 | 有效个人访问令牌，须对应当前部署已配置的计算规格管理员。 |
| `X-Workspace-ID` | string | 是 | 唯一非空鉴权工作区，当前主体需有相应访问；不是目标实例工作区筛选。 |
| `id` | string | 是 | 目标实例ID，服务按该ID解析实际所属工作区。 |

本接口不读取业务请求体；不通过body提交目标工作区或状态。
:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "id": "cr-example",
    "workspace_id": "target-workspace",
    "name": "示例实例",
    "description": "",
    "kind": "task",
    "spec_id": "spec-example",
    "cpu": 1,
    "memory_gib": 4,
    "gpu": 0,
    "cpu_milli": 1000,
    "memory_mib": 4096,
    "gpu_count": 0,
    "gpu_memory_mib": 0,
    "gpu_cores": 0,
    "min_replicas": 0,
    "max_replicas": 2,
    "current_replicas": 0,
    "desired_replicas": 0,
    "go_worker_image_id": "",
    "python_worker_image_id": "",
    "worker_images": [
      {
        "worker_type": "python-worker",
        "image_id": "image-example",
        "platform": "linux"
      }
    ],
    "platform": "linux",
    "auto_suspend_minutes": 30,
    "scale_reason": "manual_resume",
    "is_default": false,
    "status": "IDLE",
    "status_message": "",
    "created_by": "creator-example",
    "allowed_actions": [],
    "created_at": "2026-11-12T07:00:00Z",
    "updated_at": "2026-11-12T07:00:00Z"
  }
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 成功为OK。 |
| `msg` | string | 成功为OK。 |
| `data` | object | 当前读取或操作后的数据。 |
| `data.id` | string | 计算实例ID。 |
| `data.workspace_id` | string | 实例实际所属工作区，与鉴权头分开。 |
| `data.name` | string | 实例名称。 |
| `data.description` | string | 实例描述，可为空字符串。 |
| `data.kind` | string | task或query。 |
| `data.spec_id` | string | 关联规格ID。 |
| `data.cpu` | integer | 兼容CPU规格字段，单位核；不与cpu_milli混用。 |
| `data.memory_gib` | integer | 兼容内存规格字段，单位GiB。 |
| `data.gpu` | integer | 兼容GPU规格字段。 |
| `data.cpu_milli` | integer | 规格CPU，单位毫核。 |
| `data.memory_mib` | integer | 规格内存，单位MiB。 |
| `data.gpu_count` | integer | 规格GPU数量。 |
| `data.gpu_memory_mib` | integer | 规格GPU显存，单位MiB。 |
| `data.gpu_cores` | integer | 规格GPU核心字段。 |
| `data.min_replicas` | integer | 配置的最小副本字段，不等同当前观测副本。 |
| `data.max_replicas` | integer | 每个Worker类型的副本上限，不是所有类型的总和上限。 |
| `data.current_replicas` | integer | 当前实例汇总副本字段；与按类型观测分开。 |
| `data.desired_replicas` | integer | 实例目标副本字段，不表示已就绪。 |
| `data.go_worker_image_id` | string | 兼容Go Worker镜像ID，可为空。 |
| `data.python_worker_image_id` | string | 兼容Python Worker镜像ID，可为空。 |
| `data.worker_images` | object（对象数组），可省略 | 按Worker类型选择的镜像，可省略；每项字段见下表。 |
| `data.platform` | string | Worker平台配置。 |
| `data.auto_suspend_minutes` | integer | 自动暂停分钟配置，不是本次操作耗时保证。 |
| `data.scale_reason` | string | 最近扩缩或生命周期原因。 |
| `data.is_default` | boolean | 是否默认实例，可为false。 |
| `data.status` | string | 父实例状态；当前模型包含IDLE、DEPLOYING、SCALING、ACTIVE、DRAINING、SUSPENDED、TERMINATING、ERROR等，不与Worker状态合并。 |
| `data.status_message` | string | 状态文本，可为空。 |
| `data.py_requirements_txt` | string，可省略 | 可选的已保存Python依赖文本，非空时可能返回；当前typed SDK模型未声明此字段。 |
| `data.py_requirements_sha` | string，可省略 | 可选已保存依赖内容哈希；当前typed SDK模型未声明此字段。 |
| `data.py_deps` | object，可省略 | DTO声明可选观测对象，但本组三生命周期当前转换器不填充；不能依赖此字段读取安装进度。 |
| `data.created_by` | string | 创建主体。 |
| `data.allowed_actions` | string（字符串数组） | 允许动作投影；本组三生命周期不单独构造动作，空数组不是管理员资格判定。 |
| `data.last_activation_at` | string，可省略 | 最近激活时间，RFC3339，未记录时省略。 |
| `data.last_active_at` | string，可省略 | 最近活跃时间，RFC3339，未记录时省略。 |
| `data.created_at` | string | 创建时间，RFC3339。 |
| `data.updated_at` | string | 更新时间，RFC3339；不是调用者可提交的并发版本。 |

嵌套镜像、声明观测对象和父/Worker状态关系见[公共对象](compute-runtime-admin-objects.md)。
:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 按失败阶段与动作区分。 |
| `msg` | string | 错误文本；部分分支本地化，不回显未分类底层错误。 |
| `data` | null | 本示例为null；共享鉴权错误分支可能省略。 |

| HTTP / code | 条件与处理 |
| --- | --- |
| 400 / INVALID_PARAMS | 缺少鉴权工作区、主体或资源ID。 |
| 403 / ErrForbidden | 权限检查边界拒绝管理员事实、当前主体或工作区访问。 |
| 503 / ErrServiceUnavailable | 已分类的共享授权不可用，不推广到所有目录失败。 |
| 404 / RESUME_ADMIN_FAILED | 目标实例未找到；该分支机器码与运行查询的NOT_FOUND不同。 |
| 409 / CANNOT_RESUME | 父实例当前状态不满足SUSPENDED前置。 |
| 409 / LIFECYCLE_CONFLICT | 恢复/重试的预期状态CAS与并发变更冲突。 |
| 409 / RESOURCE_BUSY | 已分类的生命周期租约丢失或Cloud拆除仍在进行；先核对原操作。 |
| 503 / RESUME_ADMIN_FAILED | 已分类为运行服务未配置。 |
| 500 / RESUME_ADMIN_FAILED | 未分类的停止、状态写入、回读或目录事实失败；错误后核对实际状态。 |

不同handler、身份和恢复阶段见[错误与恢复](compute-runtime-admin-errors-recovery.md)。
:::::
::::::
:::::::
