PutBucketTrash
更新时间：2026-09-18
接口描述
本接口用于开通 Bucket Trash 功能。用户必须是源 Bucket 的 owner 且拥有 FULL_CONTROL 权限，且是目标 Bucket 的 owner。
开通 Bucket Trash 功能后，删除 Bucket 中的 Object 时，Object 会被移动到指定回收站目录；未开通 Bucket Trash 功能的 Bucket，或删除回收站目录内的 Object 时，Object 会被彻底删除。
请求
请求结构
Http
1PUT /?trash HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Authorization: <AuthorizationString>
5Content-Type: application/json
6Content-Length: <ContentLength>请求头域
无特殊 Header 参数。
请求参数
| 参数名 | 类型 | 位置 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| trash | String | Query | 是 | 无 | 开通 Bucket Trash 功能的子资源标识。 |
| trashDir | String | Body | 否 | .trash |
回收站的目录名称，长度不超过 1024 字节。只能包含字母、数字、中文、下划线（_）、短横线（-）和小数点（.），不能包含 /。 |
说明：
- 若已开通 trash 功能，会覆盖原目录名。
- "trashDir" 只能包含字母，数字，中文，下划线（_）和短横线（-），小数点（.）。包含 "/" 会报错。
- 开通了 trash 功能的 bucket，删除 object 会到回收站中（回收站中的 object 的全称是：trashDir + '/' + old object name）。未开通此功能的 bucket，或者开通此功能的 bucket 且删除回收站内的 object 时，会彻底删除。
- 归档类型文件不支持 Bucket Trash，删除归档类型文件时会直接删除。
响应
响应头域
无特殊响应头域。
响应参数
成功开通 Bucket Trash 功能时，服务端返回 200 OK，响应 Body 为空。
| HTTP 状态码 | Error Code | 说明 |
|---|---|---|
| 400 | MalformedJSON | JSON 格式错误。 |
| 400 | EntityTooLarge | trash 目录名过长，不能超过 1024 字节。 |
| 400 | InvalidTrashDirectoryName | trash 目录包含非法字符，只能包含字母、数字、中文、下划线（_）、短横线（-）和小数点（.）。 |
| 404 | NoSuchBucket | Bucket 不存在。 |
| 403 | AccessDenied | 没有权限，只有 Bucket owner 且具有 FULL_CONTROL 权限可以操作。 |
示例
请求示例
Http
1PUT /?trash HTTP/1.1
2Host: bucket.bj.bcebos.com
3x-bce-date: date
4Content-Length: request-body-length
5Content-Type: application/json; charset=utf-8
6Authorization: AuthorizationString
7
8{
9 "trashDir": "trashDirName"
10}响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 4db4b34d-653d-4d9a-b49b-3049ca786409
3Date: Wed, 31 May 2017 08:34:40 GMT
4Server: BceBos评价此篇文章