You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储API 参考对象基础操作SetObjectExpires
复制全文
下载 pdf
我的收藏
基础操作
SetObjectExpires
复制全文
下载 pdf
我的收藏
SetObjectExpires
功能描述​
此接口用于为对象添加过期时间，或修改对象的过期时间。​
注意事项​
调用 SetObjectExpires 接口前，您的账号需要具备 tos:SetObjectExpires 权限，否则该操作会因权限不足而失败。​
请求消息样式​
​
POST /ObjectName?objectExpires HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Thu, 28 Aug 2025 09:48:41 GMT​
Authorization: authorization string​
{ ​
"ObjectExpires": 1​
}​
​
请求参数和消息头​
该请求使用的公共请求消息头，请参见公共参数。​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
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 天后被删除。​
​
响应消息头​
该请求返回公共响应消息头，请参见公共参数。​
响应元素​
该请求响应中无消息元素。​
请求示例​
​
POST /data.txt?objectExpires HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Thu, 28 Aug 2025 09:32:02 +0000​
Authorization: authorization string​
{ ​
"ObjectExpires": 1​
}​
​
响应示例​
​
HTTP/1.1 200 OK​
Date: Thu, 28 Aug 2025 09:48:41 GMT​
Server: TosServer​
x-tos-id-2: fb7701b025f994d568b025f9-b8943ad​
x-tos-request-id: fb7701b025f994d568b025f9-b8943ad​
​
​
最近更新时间：2025.09.10 14:18:26
这个页面对您有帮助吗？
有用
有用
无用
无用