# 提交计算资源管理删除

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

持久化删除意图后返回受理回执，由后台继续清理。

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

## 调用前准备

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

先执行[删除预检查](preflight-delete.md)。默认有活动任务或绑定工作流时拒绝。force=true会在受理后重读依赖、取消活动任务并清除相关工作流/版本中的资源绑定，再推进权限与运行资源清理；它会改变业务内容，须事先确认影响与恢复方式。202不是清理完成。

## 请求参数

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

```bash
curl -X DELETE "https://api.moi.matrixorigin.cn/v5/admin/compute-resources/cr-example" \
  -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；服务从管理仓库解析实际工作区。 |
| `force` | string（查询参数） | 否 | 仅精确字符串true启用；省略、True、1均不启用。无--force CLI标志，见SDK与CLI。 |

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

## 成功响应

HTTP 202。

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

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "resource_id": "cr-example",
    "status": "TERMINATING"
  }
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 成功为OK。 |
| `msg` | string | 成功为OK。 |
| `data` | object | 本接口数据，见以下字段。 |
| `data.resource_id` | string | 已持久化删除意图的资源ID。 |
| `data.status` | string | TERMINATING，仅表示删除意图已持久化。 |

嵌套对象与省略规则见[公共对象](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 | 请求或已分类资源参数错误。 |
| 403 / ErrForbidden | 已分类的管理员资格、主体或工作区访问拒绝。 |
| 503 / ErrServiceUnavailable | 已分类的共享授权不可用，不概括所有目录/配置错误。 |
| 404 / NOT_FOUND | 目标资源未找到。 |
| 409 / DELETE_CONFLICT | 当前任务/绑定阻塞或删除意图冲突；先核对原请求。 |
| 503 / DELETE_UNAVAILABLE | 运行服务未配置或已分类删除服务不可用。 |
| 400 / DELETE_FAILED | 未分类删除失败；当前映射不是统一500。保留请求ID并核对实际阶段。 |

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

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

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