文档中心

对象存储

请输入

基础操作

SetObjectExpires

功能描述

此接口用于为对象添加过期时间，或修改对象的过期时间。

注意事项

调用 SetObjectExpires 接口前，您的账号需要具备 tos:SetObjectExpires 权限，否则该操作会因权限不足而失败。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
objectExpires	Query	String	是		代表 SetObjectExpires 请求的特殊标识。

请求元素

名称	参数类型	是否必填	示例值	说明
ObjectExpires	Integer	是	1	为对象添加过期时间，或修改对象的过期时间，过期后，TOS 将自动删除对象。单位为天，取值说明如下：正整数：对象将在指定时间过期，从对象的 Last‑Modified 时间开始计算，在到达该过期时间后的零点开始执行删除任务，例如设置 ObjectExpires 参数的值为 3，对象的 Last‑Modified 时间为 2024-09-26 12:00，则该对象将于 2024-09-30 00:00 过期。 0：永不过期，对象将持续保留在存储桶中，直至您手动删除该对象，或者配置生命周期规则将其删除。您可以通过设置该参数的值为 0 的方式，使指定时间过期的对象变为永不过期。说明对象过期时间优先级高于生命周期的删除规则，例如设置对象过期时间为 5 天，生命周期规则指定该对象 3 天后删除，最终将按照对象过期时间执行，即对象将于 5 天后被删除。

响应消息头

该请求返回公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

响应示例

最近更新时间：2025.09.10 14:18:26

这个页面对您有帮助吗？

有用

无用