删除前检查¶

检查删除计算实例前需要处理的活动任务和工作流绑定。

GET https://moi.matrixorigin.cn/newmoi/compute-resources/{resource_id}/preflight-delete

调用前准备¶

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

请求参数¶

请求示例

curl "https://moi.matrixorigin.cn/newmoi/compute-resources/$RESOURCE_ID/preflight-delete" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数

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

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "active_tasks": 1,
    "active_task_ids": ["task-001"],
    "bound_workflows": 1,
    "bound_workflow_details": [
      {
        "id": "wf-001",
        "name": "daily-load"
      }
    ]
  }
}

字段说明

通用字段

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	object	响应数据。

删除检查

下面表格展开响应示例中 data 对象；每一行是该对象的一个字段。

字段	类型	说明
`active_tasks`	integer	活动任务数。
`active_task_ids`	array of string	活动任务 ID；存在活动任务时返回。
`bound_workflows`	integer	绑定工作流数。
`bound_workflow_details`	array of object	绑定工作流详情；存在绑定时返回。

关联工作流

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

字段	类型	说明
`id`	string	工作流 ID。
`name`	string	工作流名称。
`node_names`	array of string	绑定该实例的节点名称；有值时返回。

本文中，类型后的 [] 表示数组，例如 string[] 是字符串数组；字段路径中的 [] 表示数组中的每一项，例如 data.bound_workflow_details[].id 表示 data.bound_workflow_details 数组中每一项的 id 字段。

错误响应¶

响应示例

{
  "code": "PREFLIGHT_FAILED",
  "msg": "服务端错误",
  "data": null
}

字段说明

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

后续操作¶

先处理活动任务和工作流绑定；无依赖后再次预检，再删除计算实例。

最后更新于 2026 年 9 月 3 日