全部文档
当前文档
最近更新时间：2025-06-20 17:29:18
KS3支持用户对桶配置回收站规则，规则配置成功后，桶内的文件被删除时会先进入回收站。用户可设置回收站内文件保留时长，到达指定时间后，KS3会自动彻底删除回收站内的文件。
1. 回收站相关内容，请参加文档：回收站。
2. 以下示例均以Linux为例。
如果桶此前未设置过回收站配置，则使用该命令将为桶添加回收站配置。如果桶已存在回收站配置，则使用该命令将直接覆盖已有的回收站配置。
添加或修改回收站配置步骤如下：
1. 创建本地文件，并在文件中添加回收站规则。
2. KS3Util先从本地文件中读取回收站配置，然后将读取到的回收站配置添加到指定的桶。
./ks3util retention --method put ks3://bucketname local_xml_file参数 | 说明 |
bucketname | 添加或修改回收站配置的桶名称。 |
local_xml_file | 配置回收站规则的本地文件名称，例如localfile.xml。 |
1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
2. 开启回收站需具备ks3:PutBucketRetention权限。
a. 在本地创建名为localfile.xml的文件，并根据使用场景写入不同的回收站规则。
开启回收站，并设置当Object进入回收站90天后彻底删除。
<RetentionConfiguration>
<Rule>
<Status>Enabled</Status>
<Days>90</Days>
</Rule>
</RetentionConfiguration>为samplebucket桶添加回收站规则。
./ks3util retention --method put ks3://samplebucket localfile.xml以下输出结果表明已成功添加回收站规则。
0.204926(s) elapsed./ks3util retention --method get ks3://bucketname [local_xml_file]参数 | 说明 |
bucketname | 获取回收站配置的桶名称。 |
local_xml_file | 用于存放回收站配置的本地文件名称，例如localfile.xml。如果未指定此参数，则回收站配置将直接输出到屏幕。 |
1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
2. 查询回收站配置需具备ks3:GetBucketRetention权限。
获取目标桶samplebucket的回收站配置，并将配置结果写入本地文件localfile.xml。
./ks3util retention --method get ks3://samplebucket localfile.xml以下输出结果表明已成功获取回收站配置，并将其写入本地localfile.xml文件。
0.188731(s) elapsed./ks3util retention --method delete ks3://bucketname参数 | 说明 |
bucketname | 关闭回收站功能的Bucket名称。 |
1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
2. 关闭回收站需具备ks3:GetBucketRetention、ks3:PutBucketRetention权限。
关闭samplebucket的回收站功能。
./ks3util retention --method delete ks3://samplebucket以下输出结果表明已成功关闭samplebucket的回收站功能。
0.156663(s) elapsed纯净模式