重试计算资源

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

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

调用前准备

准备当前部署有效身份、已配置的计算规格管理员资格和可访问的鉴权工作区。工作区Owner或Genesis管理scope不能替代。将示例ID替换为获准读取或操作的目标,详见计算实例。

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

请求参数

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

参数

类型

是否必填

说明

X-API-Key

string

示例是

有效个人访问令牌,须对应当前部署已配置的计算规格管理员。

X-Workspace-ID

string

是

唯一非空鉴权工作区,当前主体需有相应访问;不是目标实例工作区筛选。

id

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": "retry",
    "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"
  }
}

字段

类型

说明

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状态关系见公共对象。

错误响应

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

字段

类型

说明

code

string

按失败阶段与动作区分。

msg

string

错误文本;部分分支本地化,不回显未分类底层错误。

data

null

本示例为null;共享鉴权错误分支可能省略。

HTTP / code

条件与处理

400 / INVALID_PARAMS

缺少鉴权工作区、主体或资源ID。

403 / ErrForbidden

权限检查边界拒绝管理员事实、当前主体或工作区访问。

503 / ErrServiceUnavailable

已分类的共享授权不可用,不推广到所有目录失败。

404 / RETRY_ADMIN_FAILED

目标实例未找到;该分支机器码与运行查询的NOT_FOUND不同。

409 / CANNOT_RETRY

父实例当前状态不满足ERROR前置。

409 / LIFECYCLE_CONFLICT

恢复/重试的预期状态CAS与并发变更冲突。

409 / RESOURCE_BUSY

已分类的生命周期租约丢失或Cloud拆除仍在进行;先核对原操作。

503 / RETRY_ADMIN_FAILED

已分类为运行服务未配置。

500 / RETRY_ADMIN_FAILED

未分类的停止、状态写入、回读或目录事实失败;错误后核对实际状态。

不同handler、身份和恢复阶段见错误与恢复。

最后更新于