对象存储BOS

    PutBucketTrash

    接口描述

    本接口用于开通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
    上一篇
    跨域访问
    下一篇
    GetBucketTrash