开通Bucket回收站功能
更新时间:2021-12-29
接口说明
本接口用于开通Bucket Trash功能,用户必须是源Bucket的owner且拥有FULL_CONTROL权限,且是目标Bucket的owner。
请求URI
PUT /v1/{bucketName}/?trash
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
|---|---|---|---|---|---|
| bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
请求体参数
请求体字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| trashDir | String | 否 | 回收站的目录名称,有长度限制。可选,不填默认名为.trash | trashDirName |
响应体参数
无
请求示例
JSON
1PUT /v1/bucketName_example/?trash
2<公共请求头>
3
4
5{
6 "trashDir" : "trashDirName"
7}
响应示例
无
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| MalformedJSON | Json格式错误 | 400 | Json格式错误 |
| EntityTooLarge | trash目录名过长 | 400 | 不超过1024字节 |
| InvalidTrashDirectoryName | trash目录包含非法字符 | 400 | 只能包含字母,数字,中文,下划线(_)和短横线(-),小数点(.) |
| NoSuchBucket | bucket不存在 | 404 | bucket不存在 |
| AccessDenied | 没有权限 | 403 | 只有bucket owner且具有FULL_CONTROL可以操作 |
