PutBucketTrash--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

PutBucketTrash

最近更新时间：2025.03.25 20:57:06首次发布时间：2025.03.25 20:57:06

功能描述

此接口用于为分层命名空间设置回收站功能。回收站功能开启后，删除文件或者目录，TOS会将被删除的文件和目录移动到规则中指定的回收站目录中。同时，TOS 将按照规则中指定的过期时间，自动删除回收站中的文件和目录。

使用说明

目前该接口仅支持在分层命名空间使用，功能详情请参见回收站。
请求消息样式

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
{
    "BucketTrash": {
        "Trash": {
            "TrashPath": ".Trash",
            "CleanInterval": 7,
            "Status": "Enabled"
        }
    }
}

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
trash	Query	String	是	-	代表 PutBucketTrash 请求的特殊标识。

请求元素

名称	参数类型	是否必填	示例值	说明
BucketTrash	Container	是		回收站规则信息。
TrashPath	String	是	.Trash	回收站目录。
CleanInterval	Integer	是	7	文件或目录进入回收站后过期删除的天数，必须为正整数。
Status	String	是	Enabled	设置回收站是否开启，取值说明如下： `Enabled`：表示开启回收站功能。 `Disabled`：表示暂停回收站功能。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

请求示例 1

开启回收站功能，回收站路径为根目录下的 .Trash，过期删除时间为 7 天。

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
{
    "BucketTrash": {
        "Trash": {
            "TrashPath": ".Trash",
            "CleanInterval": 7,
            "Status": "Enabled"
        }
    }
}

响应示例1

无。

请求示例 2

暂停回收站功能。

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
{
    "BucketTrash": {
        "Trash": {
            "TrashPath": ".Trash",
            "CleanInterval": 7,
            "Status": "Disabled"
        }
    }
}

响应示例2

无。