# Xóa tệp trên lưu trữ đám mây theo lô

Xóa các tệp Cloud Storage theo ID.
- **Điều kiện tiên quyết**: mọi ID phải tra cứu được trong nhóm của bạn; **nếu chỉ một ID không tra cứu được thì cả lô bị từ chối và hoàn tác**, kể cả những ID đã bị xóa trước đó.
- **Tác động**: đây là xóa mềm. Dung lượng được giải phóng trong cùng một giao dịch, và các đối tượng đã lưu được xóa theo cơ chế nỗ lực tối đa — lỗi phía lưu trữ được ghi log nhưng không làm lệnh gọi thất bại, nên một đối tượng có thể tồn tại lâu hơn bản ghi của nó. Các liên kết thẻ không được dọn dẹp.
- **Hoàn tất**: đồng bộ. Hãy xác nhận dung lượng đã giải phóng bằng `/cloudstorage/info`.

Các mã lỗi nghiệp vụ đã ghi nhận: `39011`. Xem [Error Codes](../Getting%20Started/error-codes.md) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

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

## Request fields (application/json):

  - `ids` (array, required)
    ID các tệp cloud storage cần xóa.
    Example: ["1800000000001001","1800000000001002"]

## Response 200 fields (application/json):

  - `code` (integer, required)
    Mã kết quả. `0` nghĩa là thành công; các mã khác cho biết có ngoại lệ.
    Example: 0

  - `msg` (string | null, required)
    Thông báo lỗi.
    Example: null

  - `requestId` (string)
    ID yêu cầu của tác vụ. Trường này có thể xuất hiện khi yêu cầu đi qua API gateway.
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (null)
    Example: null