DeleteBucketTrash
更新时间：2026-09-18
接口描述
本接口用于关闭 trash 功能。用户必须是源 Bucket 的 owner 且拥有 FULL_CONTROL 权限，且是目标 Bucket 的 owner。
请求
请求结构
Http
1DELETE /?trash HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Authorization: <AuthorizationString>请求参数
| 参数名 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
| trash | String | Query | 是 | 固定查询参数，用于关闭 trash 功能，无需设置参数值。 |
该接口无请求 Body。
响应
响应头域
无特殊 Header 参数。
响应参数
成功响应不返回响应 Body。返回结果说明如下：
| 结果 | HTTP Status | Error Code | 说明 |
|---|---|---|---|
| 成功 | 204 | - | 关闭成功。 |
| Bucket 不存在 | 404 | NoSuchBucket | 指定的 Bucket 不存在。 |
| 没有权限 | 403 | AccessDenied | 只有 Bucket owner 可以操作。 |
说明：即使未开通 trash 功能也返回 204，满足 DELETE 幂等。
示例
请求示例
Http
1DELETE /?trash HTTP/1.1
2Host: bucket.bj.bcebos.com
3x-bce-date: date
4Authorization: AuthorizationString响应示例
Http
1HTTP/1.1 204 OK
2x-bce-request-id: 4db4b34d-653d-4d9a-b49b-3049ca786409
3Date: Wed, 31 May 2017 08:34:40 GMT
4Server: BceBos
5Connection: keep-alive评价此篇文章