## 功能描述此接口用于获取分层命名空间的回收站规则。 ## 使用说明目前该接口仅支持在分层命名空间使用，功能详情请参见[回收站](/docs/6349/1458171)。 **请求消息样式** ```JSON GET /?trash HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string ``` ## **请求参数和消息头** 该请求使用的公共请求消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/74863)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |trash |Query |String |是 |\- |代表 GetBucketTrash 请求的特殊标识。 | ## **请求元素** 该请求不使用消息元素。 ## **响应消息头** 该请求返回的公共响应消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044)。 ## **响应元素** |**名称** |**参数类型** |是否必填 |示例值 |**说明** | |---|---|---|---|---| |BucketTrash |Container |是 |* |回收站规则信息。 | |TrashPath |String |是 |.Trash |回收站的全路径。 | |CleanInterval |Integer |是 |7 |文件或目录进入回收站后过期删除的天数，必须为正整数。 | |Status |String |是 |Enabled |设置回收站是否开启，取值说明如下：|\ | | | | ||\ | | | | |* `Enabled`：表示开启回收站功能。|\ | | | | |* `Disabled`：表示暂停回收站功能。 | ## **请求示例** ```JSON GET /?trash HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: Mon, 14 Apr 2021 01:17:29 GMT Authorization: authorization string ``` ## **响应示例** ```JSON HTTP/1.1 200 OK Date: Fri, 30 Jul 2021 13:53:55 GMT Server: TosServer x-tos-id-2: 1e89f203jld00006-a444fd0 x-tos-request-id: 1e89f203b2d00006-a444ed0 Content-Length: *** { "Trash": { "TrashPath": ".Trash", "CleanInterval": 7, "Status": "Enabled" } } ``` 如果没有设置回收站规则，则返回默认的规则，示例如下。 ```JSON HTTP/1.1 200 OK Date: Fri, 30 Jul 2021 13:53:55 GMT Server: TosServer x-tos-id-2: 1e89f203jld00006-a444fd0 x-tos-request-id: 1e89f203b2d00006-a444ed0 Content-Length: *** { "Trash": { "TrashPath": ".Trash", "CleanInterval": 7, "Status": "Disabled" } } ```

对象存储