## 功能描述此接口用于为分层命名空间设置回收站功能。回收站功能开启后，删除文件或者目录，TOS会将被删除的文件和目录移动到规则中指定的回收站目录中。同时，TOS 将按照规则中指定的过期时间，自动删除回收站中的文件和目录。 ## 使用说明目前该接口仅支持在分层命名空间使用，功能详情请参见[回收站](/docs/6349/1458171)。 **请求消息样式** ```JSON PUT /?trash HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string Content-Length: ContentLength Content-MD5: MD5 { "Trash": { "TrashPath": ".Trash", "CleanInterval": 7, "Status": "Enabled" } } ``` ## **请求参数和消息头** 该请求使用的公共请求消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/74863)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |trash |Query |String |是 |\- |代表 PutBucketTrash 请求的特殊标识。 | ## **请求元素** |**名称** |**参数类型** |是否必填 |示例值 |**说明** | |---|---|---|---|---| |BucketTrash |Container |是 |* |回收站规则信息。 | |TrashPath |String |是 |.Trash |回收站目录。 | |CleanInterval |Integer |是 |7 |文件或目录进入回收站后过期删除的天数，必须为正整数。 | |Status |String |是 |Enabled |设置回收站是否开启，取值说明如下：|\ | | | | ||\ | | | | |* `Enabled`：表示开启回收站功能。|\ | | | | |* `Disabled`：表示暂停回收站功能。 | ## **响应消息头** 该请求返回的公共响应消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044)。 ## **响应元素** 该请求响应中无消息元素。 ## **请求示例** ### **请求示例 1** 开启回收站功能，回收站路径为根目录下的 `.Trash`，过期删除时间为 7 天。 ```JSON PUT /?trash HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: authorization string Content-Length: ContentLength Content-MD5: MD5 { "Trash": { "TrashPath": ".Trash", "CleanInterval": 7, "Status": "Enabled" } } ``` ### **响应示例1** 无。 ### **请求示例 2** 暂停回收站功能。 ```JSON PUT /?trash HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: authorization string Content-Length: ContentLength Content-MD5: MD5 { "Trash": { "TrashPath": ".Trash", "CleanInterval": 7, "Status": "Disabled" } } ``` ### **响应示例2** 无。

对象存储