## 功能描述此接口用于为对象添加过期时间，或修改对象的过期时间。 ## 注意事项调用 SetObjectExpires 接口前，您的账号需要具备 tos:SetObjectExpires 权限，否则该操作会因权限不足而失败。 ## 请求消息样式 ```Bash 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 } ``` ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |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` 的方式，使指定时间过期的对象变为永不过期。|\ | | | | ||\ | | | | |:::tip|\ | | | | |对象过期时间优先级高于生命周期的删除规则，例如设置对象过期时间为 5 天，生命周期规则指定该对象 3 天后删除，最终将按照对象过期时间执行，即对象将于 5 天后被删除。|\ | | | | ||\ | | | | |:::| ## 响应消息头该请求返回公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## 响应元素该请求响应中无消息元素。 ## 请求示例 ```Bash 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 } ``` ## 响应示例 ```Bash 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 ```

对象存储