GetBucketTrash
更新时间:2022-10-28
接口描述
本接口用于获取Bucket Trash开通状态,返回当前trash目录名,默认为.trash。用户必须是源Bucket的owner且拥有FULL_CONTROL权限,且是目标Bucket的owner。
请求
-
请求语法
GET /?trash HTTP/1.1
Host:
.bj.bcebos.com Date: Date
Authorization: AuthorizationString
-
请求头域
无特殊Header参数
-
请求元素
无
响应
-
响应头域
无
-
响应元素
名称 描述 trashDir 回收站的路径名称,有长度限制。可选,不填默认名为 .trash
返回结果解释如下:
结果 http status error code 说明 成功 200 - - bucket不存在 404 NoSuchBucket - trash功能未开通 404 NoSuchTrashDirectory - 没有权限 403 AccessDenied 只有bucket owner且具有FULL_CONTROL可以操作
示例
-
请求示例
GET /?trash HTTP/1.1 Host: bucket.bj.bcebos.com x-bce-date: date Authorization: AuthorizationString
-
响应示例
HTTP/1.1 200 OK x-bce-request-id: 4db4b34d-653d-4d9a-b49b-3049ca786409 Date: Wed, 31 May 2017 08:34:40 GMT Content-Length: request-body-length Content-Type: application/json; charset=utf-8 Server: BceBos Connection: keep-alive { "trashDir": ".trash/" }