回收站

为避免由于误删除KPFS文件系统中的文件导致业务受阻或数据丢失，推荐您使用文件系统时开启回收站功能。开启回收站后，被删除的文件或目录将暂存在回收站目录中，并在规定的保留时间之后彻底删除。

使用说明

1. 支持产品类型及地域

   1. 容量Ⅰ型、容量Ⅱ型：华北1（北京）、西北3区（宁夏）、西北4（海东）、西北1（庆阳）、西北2（自用）

   2. 标准型：华北1（北京）

2. 费用说明

   1. 文件删除后移入至文件系统下的.trash虚拟目录下，该虚拟目录的使用量将不受文件系统购买容量的限制，但如果您的总使用量（normal（normal表示非.trash目录）+trash（表示.trash目录））超出文件系统的购买容量，超出部分将按照回收站的容量单价按天收取费用。

      1. 回收站容量单价：与计费说明部分的文件系统配置容量单价保持一致。

      2. 计费示例：您的文件系统购买容量为10TiB，KPFS每小时整点统计一次normal+trash的总使用量，1:00统计到normal使用量为8TiB，trash使用量为3TiB，那该小时的超出部分为8TiB+3TiB-10TiB=1TiB；2:00统计到normal使用量为8TiB，trash使用量为4TiB，那该小时的超出部分为8TiB+4TiB-10TiB=2TiB。该天超出部分的计费容量为各小时超出部分加和 / 超出小时数，即1TiB+2TiB / 2=1.5TiB。

3. 数据进入回收站的条件

   1. 配置文件系统回收站保留时间≥1天。

   2. 在挂载KPFS文件系统的计算节点删除文件系统中文件。

   3. 文件将被移入.trash虚拟目录。

      

      回收站事实上只对文件有效，目录会被立即删除。如果被删除的是空目录将不会进入回收站，即无法恢复。

      符号链接（软链、symlink）无法进入回收站，因此无法通过回收站恢复，只能通过重建的方式来恢复。

4. 数据进入回收站的格式

   1. '66637676|dir1|dir2|file.txt'：起首的数字是 inode，而后续的管道符号 | 也仅仅是一种展示优化，代表目录结构。

5. 删除回收站数据

   1. 单个/批量删除：通过KPFS控制台、调用OpenAPI、命令行。

   2. 清空数据：通过KPFS控制台、调用OpenAPI。

6. 恢复回收站数据

   1. 单个/批量恢复：通过KPFS控制台、调用OpenAPI、命令行。

   2. 全部恢复：暂不支持。

      

      恢复时会连带恢复原始目录路径，但无法保持先前的目录属性；如果文件所在的目录不存在，将会以 root 用户身份自动逐级创建（类似于 sudo mkdir -p 的效果）。

      如果文件系统中已存在相同路径的文件或目录，那么恢复的文件名后会加一个整数序号消除冲突，比如 /a/b/c.txt 会恢复成 /a/b/c.txt-1 。如果在回收站中同时选中多个文件，将会按列表顺序依次尝试恢复，路径冲突的项目会被跳过。

操作步骤

设置回收站

1. 登录文件存储KPFS控制台。

2. 在文件系统列表页面，单击文件系统名称。

3. 在回收站-回收站详情-回收站状态，点击编辑：

   参数	说明
   回收站状态	关闭回收站后，删除文件将不会进入回收站。 开启回收站后，删除文件将进入回收站，且文件会按删除文件时刻设置的回收站保留天数进行自动清理。 开启后，如果文件系统mormal使用量+trash使用量超出文件系统配置容量，超出部分将按照回收站的容量单价按天收取费用。
   保留天数	仅回收站状态为开启时支持设置，范围为1-30天。

4. 点击确定，完成回收站设置。

查看回收站文件

1. 登录文件存储KPFS控制台。

2. 在文件系统列表页面，单击文件系统名称。

3. 在回收站-回收站详情及文件列表，可以查看回收站内的文件信息。

   参数	说明
   文件总数	回收站内的文件总数量。
   文件总大小	回收站内的文件总大小。
   原目录名称	删除前原文件的目录路径名称。比如：dir/subdir。
   大小	文件大小。
   原文件名称	删除前原文件的名称。比如：file。
   删除时间	该文件的删除时间，即进入回收站的时间。
   操作	恢复：参考恢复回收站文件。 删除：参考删除回收站文件。
   搜索	支持根据目录名称或文件名称关键字进行搜索。

恢复回收站文件

1. 登录文件存储KPFS控制台。

2. 在文件系统列表页面，单击文件系统名称。

3. 在回收站-文件列表-操作，点击恢复，进行单个文件恢复。

   在回收站-文件列表，选择多个要恢复的文件，点击列表上方的恢复，进行批量文件恢复。

4. 在弹出的对话框中，点击恢复，完成文件恢复。

删除回收站文件

1. 登录文件存储KPFS控制台。

2. 在文件系统列表页面，单击文件系统名称。

3. 在回收站-文件列表-操作，点击删除，进行单个文件删除。

   在回收站-文件列表，选择多个要删除的文件，点击列表上方的删除，进行批量文件删除。

4. 在弹出的对话框中，点击删除，完成文件删除。

清空回收站

1. 登录文件存储KPFS控制台。

2. 在文件系统列表页面，单击文件系统名称。

3. 在回收站-文件列表，点击列表上方的清空。

4. 在弹出的对话框中，点击清空，完成回收站内文件清空。

   

   清空后回收站中的文件会彻底删除，将无法找回，请谨慎操作。

回收站容量监控

1. 登录文件存储KPFS控制台。

2. 在文件系统列表页面，单击文件系统名称。

3. 在监控-文件系统页签，可以查看使用量(normal)及使用量(normal+trash)变化趋势。