文档中心

对象存储

请输入

数据安全

设置保留策略（WORM）

在医疗、金融等行业中，存在严格的合规要求，规定某些文件在特定时间段内不能被删除或覆盖，以确保数据的完整性、可审计性。为了满足此类需求，TOS 提供了保留策略功能，用于确保对象在指定时间内，不能被任何人删除或覆盖，实现一次写入多次读取（Write Once Read Many，简称 WORM）的数据存储行为。本文介绍保留策略的应用场景、注意事项，以及设置保留策略的操作步骤等内容。

功能介绍

保留策略功能需要先在存储桶启用对象锁定，启用后，您可以设置桶保留时间或对象保留时间，具体说明如下：

桶保留时间：TOS 支持为存储桶设置保留时间，设置桶保留时间后，如果新上传的对象未单独设置对象保留时间，则默认会继承桶保留时间，并自动进入锁定状态，在保留时间到期前，任何人将无法删除或覆盖该对象。在设置桶保留时间之前上传的对象，则不会主动继承该保留时间。

对象保留时间：TOS 支持单独为对象设置保留时间，您可以为已上传或新上传的对象设置对象保留时间。对象保留时间优先级高于桶保留时间，如果设置了桶保留时间，同时上传对象时指定对象保留时间，对象将优先使用对象保留时间。

仅开启对象锁定功能，但未设置桶保留时间或对象保留时间，对象不会进入锁定状态，无法获得防删除和防覆盖保护。

应用场景

保留策略功能支持 WORM 特性，可支持客户以不可擦除、不可删除的格式保留电子记录，以满足特定行业监管要求，适用于需要满足合规性要求、防篡改和防删除的场景。

机器学习：经过长时间训练得到模型数据是一种宝贵资产。如果训练过程中数据源或模型数据被覆盖或误删，会导致训练任务中断，进而造成 GPU 资源浪费。通过保留策略可以保护这些数据不被随意覆盖或删除。

智能驾驶：在智能驾驶系统中，为确保传感器数据、模型训练集及日志文件等关键数据的完整性与不可篡改性，满足日趋严格的合规监管要求，可使用保留策略对相关数据进行保护，确保数据一旦写入不可删除或覆盖，提升整体系统的安全性与可信性。

金融、医疗等合规场景：金融、保险、医疗等机构需要遵守严格的法律法规，对影像资料、客户信息等敏感信息进行严格管理和保护。使用保留策略功能可以确保数据在规定的保留期内不可覆盖或删除，满足合规审计的要求。

注意事项

保留时间

对象锁定功能开启后不支持关闭，但是您可以禁用保留期。

桶保留时间支持延长和缩短，但对象保留时间仅支持延长，不支持缩短。

对象保留时间不支持取消，仅可在保留时间到期后自动失效。因此为对象设置保留时间后，在保留时间到期前，任何人（包括对象拥有者）将无法删除和覆盖该对象。

在销户、账号欠费超期情况下，即使保留时间未到期，数据也会被删除。

Appendable 类型的对象被锁定后，在保留时间内，将无法再对该对象执行追加写操作；保留时间到期后，您可以对该对象正常执行追加写操作。

设置桶保留时间后，分片不受桶保留时间规则限制，您仍可以删除存储桶内的分片。

存储桶复制

源桶和目标桶的对象锁定状态需要一致，否则无法配置同区域复制和跨区域复制规则。

存储桶复制规则和保留策略存在启用顺序限制。如果您需要在指定存储桶创建保留策略和复制规则，则必须先创建保留策略，再创建复制规则。若您的存储桶已创建复制规则，则不支持创建保留策略。

生命周期规则

当对象处于锁定状态时，在其保留时间到期前，生命周期删除规则不会生效，沉降规则仍会正常执行。保留时间到期后，生命周期删除规则方可正常生效。

生命周期规则	对象保留时间	执行结果
10 天沉降对象	20 天	对象上传后第 10 天被沉降。
10 天删除对象	20 天	对象上传后第 10 天不会被删除，上传后第 21 天被删除。
30 天沉降对象	20 天	对象上传后第 30 天被沉降。
30 天删除对象	20 天	对象上传后第 30 天被删除。

版本控制

TOS 支持为对象的每个版本设置独立的保留时间。对被锁定的对象执行删除、覆盖操作时，其结果会根据版本控制的状态表现不同的行为，说明如下：

版本控制状态	删除被锁定对象	覆盖被锁定对象（上传同名对象）
未开启	删除失败。	上传失败。
开启	支持为被锁定的对象添加删除标记，不支持彻底删除被锁定的对象。说明不支持为删除标记设置保留时间。	生成一个新版本对象，原来被锁定的对象则会转为历史版本对象。
开启后暂停	存在 null 版本对象，且被锁定，删除失败。	存在 null 版本对象，且被锁定，上传失败。

设置保留策略

设置桶保留时间

新建存储桶时设置桶保留时间

为已有存储桶设置桶保留时间

登录对象存储控制台。

在左侧导航栏，单击桶列表。

在桶列表页面，单击创建桶。

在创建存储桶页面，单击高级设置，启用保留策略。

说明

关于创建存储桶其他参数的详细介绍，请参见创建存储桶。

完成设置后，单击确定。

在左侧导航栏，单击安全管理＞保留策略。

在保留策略页面，单击编辑，启用默认保留期，设置默认保留时间。

说明

保留策略仅支持合规模式，即任何用户在保留期内均不能删除或覆盖被锁定的对象。

默认保留时间支持按天或按年配置，取值范围为 1 ～36500 天或 1 ~100 年。

默认保留时间属于相对时间，从对象上传时间为起点开始计算，并于设定的时间长度结束锁定状态。需要注意的是，分片对象的保留时间从创建分片任务的时间开始计算。

完成设置后，单击确定。

设置对象保留时间

启用对象锁定。

说明

为单个对象设置保留时间时，必须先启用对象锁定功能，否则无法单独为对象设置保留时间。

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面，单击目标桶名称。

在左侧导航栏，选择安全管理＞保留策略。

在保留策略页面，启用对象锁定，单击确定。

为对象设置保留时间。

上传对象时设置保留时间
为已上传对象设置保留时间
您可以通过以下 API 设置 x-tos-object-lock-mode 和 x-tos-object-lock-retain-until-date 参数，为对象设置保留时间，说明如下：
PutObject
PostObject
CreateMultipartUpload
CopyObject
AppendObject
登录对象存储控制台。
在左侧导航栏，单击桶列表，在桶列表页面，单击目标桶名称。
在文件列表页面，单击目标文件操作列下的 ... ＞设置保留日期。
在设置保留期对话框，设置对象被锁定的结束日期，单击确定。
说明
保留日期用于指定对象不能删除或覆盖的截止日期，属于绝对时间。设置保留日期后，对象将于保留日期的 23:59:59 结束锁定状态。
您也可以调用 PutObjectRetention 为已上传的对象设置保留时间，详细介绍，请参见PutObjectRetention。

延长保留时间

桶保留时间支持延长和缩短，但对象保留时间仅支持延长，不支持缩短。

延长桶保留时间

延长对象保留时间

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面，单击目标桶名称。

在左侧导航栏，选择安全管理＞保留策略。

在保留策略页面，单击编辑，延长默认保留时间，然后单击确定。

查看对象保留信息

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面，单击目标桶名称。

在文件列表页面，单击目标文件操作列下详情。

在对象详情面板，查看对象保留模式和保留到期日。

说明

桶清单支持导出对象的保留模式和保留到期日，您可以通过桶清单批量获取桶内对象的保留模式和保留到期日，详细介绍，请参见桶清单。

关闭桶保留时间

仅支持关闭桶保留时间，不支持取消对象已有的保留时间。关闭桶保留时间后，新上传的对象将不再自动进入锁定状态，已有对象的保留时间保持不变。

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面，单击目标桶名称。

在左侧导航栏，选择安全管理＞保留策略。

在保留策略页面，单击编辑，禁用默认保留期，单击确定。

最近更新时间：2025.09.26 15:50:14

这个页面对您有帮助吗？

有用

无用