所有文档

          对象存储 BOS

          GetBucketTrash

          接口描述

          本接口用于获取Bucket Trash开通状态,返回当前trash目录名,默认为.trash。用户必须是源Bucket的owner且拥有FULL_CONTROL权限,且是目标Bucket的owner。

          请求

          • 请求语法

            GET /?trash HTTP/1.1 Host: .bj.bcebos.com Date: Authorization:

          • 请求头域

            无特殊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/"
            }
          上一篇
          PutBucketTrash
          下一篇
          DeleteBucketTrash