# 批量删除云存储文件

按 ID 删除云存储文件。
- **前置条件**：每个 ID 都必须能在你的团队中解析；**只要有一个解析不到，整批都会被拒绝并回滚**，包括那些已被删除的 ID。
- **副作用**：软删除。配额在同一事务内释放；已存储的对象以尽力而为的方式删除——存储侧失败只记日志、不会让调用失败，因此对象可能比记录活得更久。标签关联不会被清理。
- **完成信号**：同步。请用 `/cloudstorage/info` 确认释放出的空间。

已记录的业务错误码：`39011`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

Endpoint: POST /api/cloudstorage/file/delete/batch
Version: 2026-09-05

## Request fields (application/json):

  - `ids` (array, required)
    待删除的云存储文件 ID 列表。
    Example: ["1800000000001001","1800000000001002"]

## Response 200 fields (application/json):

  - `code` (integer, required)
    返回结果码。`0` 表示成功；其他值表示异常。
    Example: 0

  - `msg` (string | null, required)
    错误信息。
    Example: null

  - `requestId` (string)
    操作请求 ID。请求经过 API 网关时可能返回该字段。
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (null)
    Example: null