恢复计算资源¶
以配置管理员身份恢复目标计算实例,返回操作后重新读取的实例对象。
POST https://api.moi.matrixorigin.cn/v5/admin/compute-resources/{id}/resume
调用前准备¶
准备当前部署有效身份、已配置的计算规格管理员资格和可访问的鉴权工作区。工作区Owner或Genesis管理scope不能替代。将示例ID替换为获准读取或操作的目标,详见计算实例。
先确认父实例为SUSPENDED。通过预期旧状态CAS把父实例目标状态重置为IDLE,再独立回读;不在此调用中启动Worker。并发操作可能改变回读结果,按返回和后续运行状态核对。 当前三端typed计算资源模型未声明非空py_requirements_txt/sha返回字段;自定义依赖实例的兼容性需单独确认。使用原始HTTP保留状态和响应,客户端解码报错后先回查,不能推断操作未发生。
请求参数¶
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"
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
示例是 |
有效个人访问令牌,须对应当前部署已配置的计算规格管理员。 |
|
string |
是 |
唯一非空鉴权工作区,当前主体需有相应访问;不是目标实例工作区筛选。 |
|
string |
是 |
目标实例ID,服务按该ID解析实际所属工作区。 |
本接口不读取业务请求体;不通过body提交目标工作区或状态。
成功响应¶
{
"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"
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
成功为OK。 |
|
string |
成功为OK。 |
|
object |
当前读取或操作后的数据。 |
|
string |
计算实例ID。 |
|
string |
实例实际所属工作区,与鉴权头分开。 |
|
string |
实例名称。 |
|
string |
实例描述,可为空字符串。 |
|
string |
task或query。 |
|
string |
关联规格ID。 |
|
integer |
兼容CPU规格字段,单位核;不与cpu_milli混用。 |
|
integer |
兼容内存规格字段,单位GiB。 |
|
integer |
兼容GPU规格字段。 |
|
integer |
规格CPU,单位毫核。 |
|
integer |
规格内存,单位MiB。 |
|
integer |
规格GPU数量。 |
|
integer |
规格GPU显存,单位MiB。 |
|
integer |
规格GPU核心字段。 |
|
integer |
配置的最小副本字段,不等同当前观测副本。 |
|
integer |
每个Worker类型的副本上限,不是所有类型的总和上限。 |
|
integer |
当前实例汇总副本字段;与按类型观测分开。 |
|
integer |
实例目标副本字段,不表示已就绪。 |
|
string |
兼容Go Worker镜像ID,可为空。 |
|
string |
兼容Python Worker镜像ID,可为空。 |
|
object(对象数组),可省略 |
按Worker类型选择的镜像,可省略;每项字段见下表。 |
|
string |
Worker平台配置。 |
|
integer |
自动暂停分钟配置,不是本次操作耗时保证。 |
|
string |
最近扩缩或生命周期原因。 |
|
boolean |
是否默认实例,可为false。 |
|
string |
父实例状态;当前模型包含IDLE、DEPLOYING、SCALING、ACTIVE、DRAINING、SUSPENDED、TERMINATING、ERROR等,不与Worker状态合并。 |
|
string |
状态文本,可为空。 |
|
string,可省略 |
可选的已保存Python依赖文本,非空时可能返回;当前typed SDK模型未声明此字段。 |
|
string,可省略 |
可选已保存依赖内容哈希;当前typed SDK模型未声明此字段。 |
|
object,可省略 |
DTO声明可选观测对象,但本组三生命周期当前转换器不填充;不能依赖此字段读取安装进度。 |
|
string |
创建主体。 |
|
string(字符串数组) |
允许动作投影;本组三生命周期不单独构造动作,空数组不是管理员资格判定。 |
|
string,可省略 |
最近激活时间,RFC3339,未记录时省略。 |
|
string,可省略 |
最近活跃时间,RFC3339,未记录时省略。 |
|
string |
创建时间,RFC3339。 |
|
string |
更新时间,RFC3339;不是调用者可提交的并发版本。 |
嵌套镜像、声明观测对象和父/Worker状态关系见公共对象。
错误响应¶
{"code":"INVALID_PARAMS","msg":"invalid compute resource request","data":null}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
按失败阶段与动作区分。 |
|
string |
错误文本;部分分支本地化,不回显未分类底层错误。 |
|
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、身份和恢复阶段见错误与恢复。