tencent cloud

对象存储

动态与公告
产品动态
产品公告
产品简介
产品概述
功能概览
应用场景
产品优势
基本概念
地域和访问域名
规格与限制
产品计费
计费概述
计费方式
计费项
免费额度
计费示例
查看和下载账单
欠费说明
常见问题
快速入门
控制台快速入门
COSBrowser 快速入门
用户指南
创建请求
存储桶
对象
数据管理
批量处理
全球加速
监控与告警
运维中心
数据处理
内容审核
智能工具箱
数据工作流
应用集成
工具指南
工具概览
环境安装与配置
COSBrowser 工具
COSCLI 工具
COSCMD 工具
COS Migration 工具
FTP Server 工具
Hadoop 工具
COSDistCp 工具
HDFS TO COS 工具
GooseFS-Lite 工具
在线辅助工具
自助诊断工具
实践教程
概览
访问控制与权限管理
性能优化
使用 AWS S3 SDK 访问 COS
数据容灾备份
域名管理实践
图片处理实践
COS 音视频播放器实践
工作流实践
数据直传
内容审核实践
数据安全
数据校验
大数据实践
COS 成本优化解决方案
在第三方应用中使用 COS
迁移指南
本地数据迁移至 COS
第三方云存储数据迁移至 COS
以 URL 作为源地址的数据迁移至 COS
COS 之间数据迁移
Hadoop 文件系统与 COS 之间的数据迁移
数据湖存储
云原生数据湖
元数据加速
数据加速器 GooseFS
数据处理
数据处理概述
图片处理
媒体处理
内容审核
文件处理
文档处理
故障处理
获取 RequestId 操作指引
通过外网上传文件至 COS 缓慢
访问 COS 时返回403错误码
资源访问异常
POST Object 常见异常
API 文档
简介
公共请求头部
公共响应头部
错误码
请求签名
操作列表
Service 接口
Bucket 接口
Object 接口
批量处理接口
数据处理接口
任务与工作流
内容审核接口
云查毒接口
SDK 文档
SDK 概览
准备工作
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
小程序 SDK
错误码
鸿蒙(Harmony) SDK
终端 SDK 质量优化
安全与合规
数据容灾
数据安全
访问管理
常见问题
热门问题
一般性问题
计费计量问题
域名合规问题
存储桶配置问题
域名和 CDN 问题
文件操作问题
日志监控问题
权限管理问题
数据处理问题
数据安全问题
预签名 URL 问题
SDK 类问题
工具类问题
API 类问题
服务协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表

配置生命周期

PDF
聚焦模式
字号
最后更新时间: 2025-12-03 11:50:24

适用场景

利用生命周期设置,可以让符合规则的对象在指定的条件下自动执行一些操作。例如:
转换存储类型:将创建的对象在指定时间后转换为低频存储类型(STANDARD_IA)、智能分层存储(INTELLIGENT_TIERING)、归档存储类型(ARCHIVE)和深度归档存储类型(DEEP_ARCHIVE)。
过期删除:设置对象的过期时间,使对象到期后被自动删除。
详情请参见 生命周期概述 文档和 生命周期配置元素 文档。

使用方法

使用对象存储控制台

2. 在左侧导航中,单击存储桶列表,进入存储桶列表页面。
3. 找到需要开启生命周期功能的存储桶,单击其存储桶名称,进入存储桶详情页。
4. 
选择
左侧的基础配置 > 生命周期配置项,配置项说明如下。



访问追踪:如果您希望设置策略类型基于“最后访问时间”的生命周期规则,请开启此选项。开启后,访问跟踪开启时间为存储桶中所有对象的最后一次访问时间。您可在第5步中配置策略类型为最后访问时间
注意:
访问追踪功能为白名单功能,需加白后使用。请联系您的商务或 联系我们,加白后即日生效。
访问追踪功能的使用限制说明如下:
目前仅支持北京、上海、广州、北京一区、重庆、新加坡、南京的存储桶开启访问追踪。
OFS 融合桶不支持开启访问追踪。
5. 单击添加规则,配置项说明如下。



基础信息
规则名称:输入您的生命周期规则名称。
策略类型:分为最后修改时间、最后访问时间。该配置项仅对已添加访问追踪功能白名单的用户可见。
最后修改时间:根据对象的最后修改时间进行规则设置。
最后访问时间:根据对象的最后访问时间进行规则设置,该配置项需加白并开启访问追踪功能(可在 第4步中 开启)才可配置。目前仅支持数据沉降到低频存储。
注意:
开启访问跟踪后,COS 才会开始记录存储桶内对象的访问时间。在开启访问追踪之前的所有访问行为,均不会被纳入访问时间分析。例如,在4月1日统计发现,对象 a(标准存储) 已10天未被访问,于当日开启访问追踪并配置生命周期规则为“对象 a 最后访问时间的5天后沉降至低频存储”,对象 a 将在4月6日被沉降至低频,而不是4月2日。
应用范围:本生命周期规则可以作用于整个存储桶,也可以作用于指定范围的对象。
当选择指定范围时,请至少配置以下其中一项:
对象前缀:可指定具有相同 对象键 前缀的对象去执行生命周期规则。不支持正则表达式。
对象标签:可指定带有同一标签的对象去执行生命周期规则,支持指定多个标签,请区分英文字母大小写。若您选择基于最后访问时间的策略类型,则不支持配置此项。
注意:
可同时指定对象前缀和对象标签。对象前缀和对象标签、对象标签和对象标签之间都为“与”的关系(即所有条件需同时满足)。例如在生命周期规则中指定对象前缀为 doc,对象标签键值对为 group = IT,则指定的对象范围为当前存储桶中对象键前缀为 doc 且对象标签为 group = IT 的所有对象。
当选择整个存储桶时,可以选择是否配置排除范围,默认关闭。支持按照以下配置项进行设置:
对象前缀:可指定排除具有相同文件前缀的对象去执行生命周期规则,目前仅支持配置单个排除前缀。注意,当前配置排除范围不支持融合桶。



规则配置
根据所选的策略类型,选择配置如下信息。
最后修改时间
最后访问时间



管理当前版本文件:您可以通过开启管理当前版本文件的选项,沉降或者删除当前版本对象。支持存储桶中的对象由标准存储等热数据沉降至低频存储等冷数据,支持对象到期后删除。
其中存储类型由热到冷分别为:标准存储 > 低频存储 > 智能分层存储 > 归档存储 > 深度归档存储,存储类型转换只能由热到冷,不能反向进行。关于存储类型的介绍和适用地域说明,请参见 存储类型概述。时间是以文件在对象存储上的修改时间为标准开始计算,修改对象的行为等同于重新上传对象。
说明:
开启了多 AZ 配置的存储桶,生命周期的转换顺序仅支持标准存储(多 AZ) > 低频存储(多 AZ) > 智能分层存储(多 AZ)/归档存储(多 AZ)
管理历史版本文件:您可以通过开启管理历史版本对象的选项,沉降或者删除历史版本对象。若您未开启该选项,我们将默认仅处理最新版本的对象。
注意:
历史版本的沉降和删除,以对象成为历史版本的时间计算,而非根据历史版本的上传时间计算。
清理无历史版本的删除标记:如果要清理无历史版本的删除标记,需要同时开启以下两项配置。
1.开启“管理历史版本文件”选项,并设置历史版本文件的到期删除。
2.开启“清理无历史版本的删除标记”选项。
注意:
此选项的生效依赖于清理历史版本的规则。勾选此项后,当对象的最新版本是删除标记(Delete Marker),通过生命周期删除最后一个历史版本对象时,会在第二天自动清理剩余的多个删除标记。例如:1月1号清理完成历史版本后,1月2号才会自动清理删除标记。详情请参见 ExpiredObjectDeleteMarker
该选项不能与管理当前版本文件中的到期删除同时开启。
删除碎片:文件上传的时候由于各种原因导致上传失败,只传输了其中的一部分,对于此类残损的文件可以设置定期删除。

管理版本文件:您可以通过开启管理版本文件的选项,通过指定文件在连续访问天数内、访问次数低于多少次来判断是否沉降版本对象。支持存储桶中的对象由标准类型(例如标准存储)沉降至低频类型(例如低频存储)。开启后,当前版本和历史版本均会沉降。
6. 信息确认无误后,单击确定,您即可看到生命周期规则。

注意:
设置生命周期规则后,如果反复修改,可能会影响生命周期规则的执行,关于规则生效的相关说明,请参见 规则生效时间说明
7. 当需要停止生命周期规则时,单击编辑,将对应规则的状态修改为关闭或者直接删除生命周期规则即可。
8. 若您需要清空当前存储桶的所有生命周期规则,单击清空全部规则即可。

规则执行优先级

每个存储桶最多可添加1000条生命周期规则。若对同一组的对象配置了多条规则且存在冲突情况,针对不同的冲突分类,对象存储会按照以下优先级执行生命周期规则。更多详细说明请参见 生命周期概述-配置元素-操作
注意:
腾讯云 COS 强烈提醒您不要针对同一组对象配置多个含冲突条件的生命周期规则,冲突执行可能导致不同的费用表现。

同一生命周期规则的不同操作

若您配置了一条生命周期规则,在规则里对同一组对象配置了不同的操作(例如沉降、删除操作),这些操作之间的执行规则和示例如下:
执行规则
示例
若同时满足删除和沉降操作,优先执行删除操作
规则 R1
1. 文件 test.txt 修改90天后沉降至低频存储。
2. 文件 test.txt 修改90天后删除。
预期结果
优先执行2,文件 test.txt 90天后被删除;1执行失败。
若同时满足多条删除操作,优先匹配时间更短的删除操作
规则 R1
1. 指定前缀 a 的文件180天后删除。
2. 指定前缀 aa 的文件90天后删除。
预期结果
假设存储桶有文件 aaa.png,指定前缀 a 和指定前缀 aa 都命中同一个文件 aaa.png,优先执行2,文件 aaa.png 90天后被删除;1执行失败。
若同时满足多条沉降操作,优先匹配目标存储类型更冷的沉降操作
规则 R1
1. 文件 test.txt 修改90天后沉降至低频存储。
2. 文件 test.txt 修改90天后沉降至归档存储。
预期结果
优先执行2,文件 test.txt 修改90天后被沉降至归档存储;1执行失败。

不同生命周期规则的不同操作

若您配置了多条生命周期规则,在不同规则里对同一组对象配置了不同的操作(例如沉降、删除操作),这些操作之间的执行规则和示例如下:
执行规则
示例
若同时满足多条规则之间不同的删除和沉降操作,优先匹配删除时间最短的操作
规则 R1
1. 文件 test.txt 修改50天后沉降至低频存储。
2. 文件 test.txt 修改10天后删除。
规则 R2
1. 文件 test.txt 修改10天后沉降至低频存储。
2. 文件 test.txt 修改30天后删除。
预期结果
匹配规则 R1,优先执行2,文件 test.txt 修改10天后被删除;规则 R2执行失败,R1的1执行失败。
若同时满足多条规则之间不同的删除操作,优先匹配时间更短的删除操作
规则 R1:文件 test.txt 修改10天后删除。
规则 R2:文件 test.txt 修改30天后删除。
预期结果
匹配 R1 规则,文件 test.txt 修改10天后被删除;规则 R2执行失败。

规则 R3:文件 example.txt 修改10天后删除。
规则 R4:文件 example.txt 修改10天后删除。
规则 R5:文件 example.txt 修改50天后删除。
预期结果
匹配 R3或 R4规则,文件 example.txt 修改10天后被删除;规则 R5执行失败。
若同时满足多条规则之间不同的沉降操作,优先匹配目标存储类型更冷的沉降操作
规则 R1:文件 test.txt 修改10天后沉降至低频存储。
规则 R2:文件 test.txt 修改10天后沉降至归档存储。
预期结果
匹配 R2 规则,文件 test.txt 修改10天后被沉降至归档存储;规则 R1执行失败。

规则 R3:文件 example.txt 修改10天后沉降至低频存储。
规则 R4:文件 example.txt 修改10天后沉降至归档存储。
规则 R5:文件 example.txt 修改10天后沉降至归档存储。
预期结果
匹配 R4或 R5规则,文件 example.txt 修改10天后被沉降至归档存储;规则 R3执行失败。

使用 REST API

您可以直接使用 REST API 配置和管理存储桶中对象的生命周期,详情请参见以下 API 文档:

使用 SDK

您可以直接调用 SDK 的生命周期方法,详情请参见下列各语言 SDK 文档:
C SDK

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈