# 预检查计算资源删除

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

查询当前活动任务与工作流绑定，供删除前检查。

```text
GET https://api.moi.matrixorigin.cn/v5/admin/compute-resources/{id}/preflight-delete
```

## 调用前准备

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

结果只描述当前读取到的依赖，不预留资源，也不授予删除权限。工作流级与节点级按工作流ID去重；部分无法解析的草稿DSL会被跳过，版本JSON解析失败则返回错误。零计数不证明后续没有新绑定或外部运行负载。

## 查询参数

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

```bash
curl --get "https://api.moi.matrixorigin.cn/v5/admin/compute-resources/cr-example/preflight-delete" \
  -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 | 是 | 唯一非空鉴权工作区；与目标资源所属工作区、列表workspace_id分开。 |
| `id` | string | 是 | 目标资源ID；服务从管理仓库解析实际工作区。 |

:::::
::::::
:::::::

## 成功响应

HTTP 200。

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

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "active_tasks": 0,
    "bound_workflows": 0
  }
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 成功为OK。 |
| `msg` | string | 成功为OK。 |
| `data` | object | 本接口数据，见以下字段。 |
| `data.active_tasks` | integer | 当前收集到的活动任务数量。 |
| `data.active_task_ids` | string（字符串数组），可省略 | 可选活动任务ID数组，空时省略。 |
| `data.bound_workflows` | integer | 按工作流ID去重的绑定工作流数。 |
| `data.bound_workflow_details` | object（对象数组），可省略 | 可选绑定工作流明细，空时省略。 |

嵌套对象与省略规则见[公共对象](compute-admin-crud-objects.md)。
:::::
::::::
:::::::

## 错误响应

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

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

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

| HTTP / code | 条件与处理 |
| --- | --- |
| 400 / INVALID_PARAMS | 缺少主体、鉴权工作区或资源ID。 |
| 403 / ErrForbidden | 已分类的管理员资格、主体或工作区访问拒绝。 |
| 503 / ErrServiceUnavailable | 已分类的共享授权不可用，不概括所有目录/配置错误。 |
| 404 / NOT_FOUND | 资源不存在或已被管理读取集合排除。 |
| 500 / ErrServer | 未分类事实读取、版本解析等服务错误。 |

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 按具体失败阶段分类。 |
| `msg` | string | 错误文本；共享错误可能本地化。 |
| `data` | null或省略 | 直接计算错误为null；共享错误形态见错误恢复。 |

:::::
::::::
:::::::

错误不代表所有阶段已回滚，见[错误与恢复](compute-admin-crud-errors-recovery.md)。
