接口描述

本接口用于获取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可以操作

示例

• 请求示例

  Plain Text 复制

  1GET /?trash HTTP/1.1
  2Host: bucket.bj.bcebos.com
  3x-bce-date: date
  4Authorization: AuthorizationString

• 响应示例

  Plain Text 复制

  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"trashDir": ".trash/"
  10}