文档中心

对象存储

请输入

生命周期管理

设置对象过期时间

TOS 支持通过 API 设置对象的过期时间，过期后，TOS 将自动删除该对象。本文介绍如何设置、修改和查看对象的过期时间。

注意事项

分类	注意事项
开始时间	对象的过期时间从 Last‑Modified 时间开始计算，单位为天。
执行时间	设置对象过期时间后，TOS 将于到达该过期时间后的零点开始执行删除任务，例如对象的 Last‑Modified 时间为 2024-09-26 12:00，对象的过期时间为 3 天，该对象将于 2024-09-30 00:00 过期。
优先级	对象过期时间优先级高于生命周期的删除规则，例如设置对象过期时间为 5 天，生命周期规则指定该对象 3 天后删除，最终将按照对象过期时间执行，即对象将于 5 天后被删除。说明您可以同时设置对象过期时间和生命周期转换存储类型的规则，例如对指定前缀对象配置文件最后修改时间 3 天后转为低频，同时为对象配置 5 天的过期时间，则该对象 3 天后转为低频， 5 天后被删除。
多版本	对象过期遵循多版本处理规则，分两步执行：首次到期：对象将被打上删除标记，转为历史版本。再次到期：历史版本沿用原对象的过期时效规则，到期后数据被彻底删除。
使用限制	软链接对象不支持设置过期时间。

操作步骤

设置对象过期时间

修改对象过期时间

查看对象过期时间

上传对象时，为对象添加过期时间

您可以在以下 API 中使用x-tos-object-expires 参数，为对象添加过期时间。该参数支持设置为正整数，单位为天，表示对象将在指定时间过期，从对象的 Last‑Modified 时间开始计算，在到达该过期时间后的零点开始执行删除任务，例如设置 x-tos-object-expires 参数的值为 3，对象的 Last‑Modified 时间为 2024-09-26 12:00，则该对象将于 2024-09-30 00:00 过期。对应 API 说明如下：

在上传对象时，为对象添加过期时间

PutObject

PostObject

CreateMultipartUpload

在追加写对象时，为对象添加过期时间

AppendObject

在复制对象时，为对象添加过期时间

CopyObject

为已上传的对象添加过期时间

您可以通过 SetObjectExpires 接口的 ObjectExpires 参数为已上传的对象添加过期时间。该参数支持设置为正整数或 0，单位为天，取值说明如下：

正整数：对象将在指定时间过期，从对象的 Last‑Modified 时间开始计算，在到达该过期时间后的零点开始执行删除任务。例如设置 ObjectExpires 参数的值为 3，对象的 Last‑Modified 时间为 2024-09-26 12:00，则该对象将于 2024-09-30 00:00 过期。

0 ：对象将持续保留在存储桶中，直至您手动删除该对象，或者配置生命周期规则将其删除。

详细介绍，请参见 SetObjectExpires。

最近更新时间：2026.07.14 16:47:43

这个页面对您有帮助吗？

有用

无用