对象存储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