接口描述

本接口用于开通Bucket Trash功能，用户必须是源Bucket的owner且拥有FULL_CONTROL权限，且是目标Bucket的owner。

请求

• 请求语法

   PUT /?trash HTTP/1.1
   Host: <BucketName>.bj.bcebos.com
   Date: <Date>
   Authorization: <AuthorizationString>
   Content-Type: application/json
   Content-Length: <ContentLength>

• 请求头域

  无特殊Header参数

• 请求元素

  名称	描述
  trashDir	回收站的目录名称，有长度限制。可选，不填默认名为.trash

  说明：

  1.若已开通trash功能，会覆盖原目录名。

  2."trashDir"只能包含字母，数字，中文，下划线（_）和短横线（-），小数点（.）。包含'/'会报错。

  3.开通了trash功能的bucket， 删除object会到回收站中(回收站中的object的全称是：trashDir + '/' + old object name)。未开通此功能的bucket，或者开通此功能的bucket且删除回收站内的object时，会彻底删除。

  4.归档类型文件不支持Bucket Trash，删除归档类型文件时会直接删除。

响应

• 响应头域

  无

• 响应元素

  结果	http status	error code	说明
  Json格式错误	400	MalformedJSON	-
  trash目录名过长	400	EntityTooLarge	不超过1024字节
  trash目录包含非法字符	400	InvalidTrashDirectoryName	只能包含字母，数字，中文，下划线（_）和短横线（-），小数点（.）
  bucket不存在	404	NoSuchBucket	-
  没有权限	403	AccessDenied	只有bucket owner且具有FULL_CONTROL可以操作

示例

• 请求示例

  PUT /?trash HTTP/1.1
  Host: bucket.bj.bcebos.com
  x-bce-date: date
  Content-Length: request-body-length
  Content-Type: application/json; charset=utf-8
  Authorization: AuthorizationString
  {
  "trashDir": "trashDirName"
  }

• 响应示例

  HTTP/1.1 200 OK
  x-bce-request-id: 4db4b34d-653d-4d9a-b49b-3049ca786409
  Date: Wed, 31 May 2017 08:34:40 GMT
  Server: BceBos