所有文档

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