回收站--对象存储-火山引擎

文档中心

对象存储

请输入

用户指南

回收站

您可以通过回收站功能，找回近期删除的数据，使数据更安全。回收站功能开启后，TOS 会将被删除的文件和目录移动到指定的回收站目录中。同时，TOS 将按照规则中指定的过期时间，自动删除回收站中的文件和目录。

前提条件

已创建分层命名空间，详细步骤请参见创建分层命名空间。

注意事项

类别		详细说明
功能说明	适用范围	仅支持对分层命名空间开启回收站功能。
	过期时间	支持自定义过期时间（以天为单位），最小值为 1 天。
	数据恢复方式	可手动处理（例如通过 `rename` 操作还原）。支持通过控制台提供的还原功能操作。
路径管理	默认路径规则	当前控制台默认路径为根目录下的`.Trash/`文件夹。当前仅支持通过 API 设置任意回收站路径，不支持控制台设置。
	路径创建与风险	开启回收站后，系统将立即创建回收站目录。注意您需要避免删除回收站目录或其父目录后，再创建同名文件。
	回收站目录操作风险	回收站目录为普通目录，您可以正常上传或删除内容，但存在以下风险：主动删除回收站内的文件或空目录时，数据将彻底删除。非空目录需等待自动清理，不支持手动彻底删除。上传对象操作可能导致被回收站自动清除。
回收站路径规则	路径长度限制	回收站路径+文件/目录实际路径总长度不得超过 1024 字符，否则会导致移入回收站失败。
	路径格式	路径格式：`回收站目录/(yyyymmddHH0000 \| yyyymmddHH3000)/实际路径`，说明如下： `yyyymmddHH` 为 UTC-0 时区的年月日小时。 `0000` 表示 1 小时中的 [0,30) 区间，3000 表示 [30,60) 区间。以 2025 年 01 月 01 日 12 点删除的文件为例： [12:00,12:30) 删除的文件或目录进入`20250101120000`目录。 [12:30,13:00) 删除的文件或目录进入`20250101123000`目录。
	同名冲突处理规则	通过追加后缀避免冲突，格式为：`yyyymmddHHMMSS.milseconds.序号` 组成说明： `yyyymmddHHMMSS`：UTC-0 时区精确到秒的时间戳。 `milseconds`：UTC-0 时区毫秒时间末 3 位。 `序号`：当文件或者目录名添加后缀 `yyyymmddHHMMSS.milseconds` 后仍然出现同名冲突时，才会在已有的后缀添加序号。示例：`20250101122510.345.1`
其他注意事项	删除操作	开启回收站后，删除非空目录时，目录及子文件立即进入回收站，但降费需等待回收站清理后生效。
其他注意事项	生命周期规则共存场景	删除流程：生命周期删除操作会先进入回收站，需同时满足回收站过期时间后彻底删除，总耗时叠加。路径重叠规则：若生命周期规则与回收站目录重叠，过期时间取并集（满足任一规则即触发删除）。转存影响：生命周期规则会对回收站内文件执行转存操作。

操作步骤

开启回收站

登录对象存储控制台。
在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。
在左侧导航栏，选择回收站，在回收站设置页面，单击编辑，配置如下参数。

参数	说明
当前状态	选择开启。
回收站路径	控制台默认设置为 `.Trash/`，开启回收站之后，执行删除的文件会放入该文件夹中。当前不支持通过控制台回收站路径，如果您确实需要自定义回收站路径，请通过 API 设置。
清理时间（天）	设置进入回收站后的文件的清理时间，单位为天，最小值为 1 天。注意满足回收站清退时间天数的文件，会被彻底删除。

参数设置完成后，单击确定。

其他操作

如果您不再需要使用回收站功能，您可以参考上述步骤，在回收站页面的当前状态参数栏，选择关闭。

在控制台使用回收站

开启回收站后的分层命名空间，您可以通过文件列表页面的特殊标识查看回收站根路径和回收站中的文件。

回收站根路径

回收站文件

开启回收站后的文件操作

操作	操作路径	作用
删除	在文件列表页面中选择文件，单击删除按钮。	文件会被放入回收站中。
彻底删除	在文件列表页面中选择文件，单击彻底删除按钮。	文件将会被彻底删除，不会被放入回收站中。
还原文件	从文件列表页面进入回收站文件夹，选择文件，单击还原按钮。	文件将会被还原到删除前的原路径。还原文件前会检测原路径是否已被占用，当原路径已被文件占用时，可使用一键重命名对还原路径进行修改。
清理回收站	从文件列表页面进入回收站文件夹，选择文件/文件夹，单击彻底删除按钮。	文件将会被彻底删除。