GetBucketTrash
更新时间：2026-09-18
接口描述
本接口用于获取 Bucket Trash 开通状态，返回当前 trash 目录名，默认为 .trash。调用用户必须是源 Bucket 的 owner 且拥有 FULL_CONTROL 权限，且是目标 Bucket 的 owner。
请求
请求结构
Http
1GET /?trash HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Authorization: <AuthorizationString>说明：
请求 URL 保持
/?trash结构；签名计算 CanonicalQueryString 时，空值 Query 参数按trash=参与计算。### 请求头域
无特殊 Header 参数。
请求参数
| 参数名 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
| trash | String | Query | 是 | 标识获取 Bucket Trash 开通状态的请求参数，参数值为空。 |
响应
响应头域
无特殊 Header 参数。
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| trashDir | String | 回收站的路径名称，有长度限制。可选，不填默认名为 .trash。 |
返回结果解释如下：
| 结果 | HTTP Status | Error Code | 说明 |
|---|---|---|---|
| 成功 | 200 | - | 获取 Bucket Trash 开通状态成功。 |
| Bucket 不存在 | 404 | NoSuchBucket | 指定 Bucket 不存在。 |
| Trash 功能未开通 | 404 | NoSuchBucketTrashDirectory | Bucket 未开通 Trash 功能，或 Trash 功能已关闭。 |
| 没有权限 | 403 | AccessDenied | 只有 Bucket owner 且具有 FULL_CONTROL 权限可以操作。 |
示例
请求示例
Http
1GET /?trash HTTP/1.1
2Host: bucket.bj.bcebos.com
3x-bce-date: date
4Authorization: AuthorizationString响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 4db4b34d-653d-4d9a-b49b-3049ca786409
3Date: Wed, 31 May 2017 08:34:40 GMT
4Content-Length: request-body-length
5Content-Type: application/json; charset=utf-8
6Server: BceBos
7Connection: keep-alive
8
9{
10 "trashDir": ".trash"
11}评价此篇文章