使用场景
媒体存储支持基于对象的生命周期配置,您可通过控制台配置相关规则,实现定时删除指定的对象、碎片,管理对象的当前版本或历史版本等。
使用说明
- 如果一个对象同时命中多条生命周期规则,媒体存储会以最短过期时间为准执行。
- 单个桶的生命周期规则条数没有限制。
- 创建生命周期规则时,规则名称不能为空,长度不能超过255个字符,且在当前桶唯一。
- 创建该条规则的应用范围有整个存储桶和指定范围,指定范围可以指定对象前缀或对象标签。
- 如果当前桶启用了WORM规则,那么该桶在合规保留期内的对象,其生命周期规则不生效。
- 生命周期支持通过控制台配置管理历史版本,但目前对象版本控制能力仅部分资源池支持,具体可参考:版本控制 。
- 修改生命周期配置后,配置不会立即对桶内所有对象生效。例如原有生命周期规则为1天过期删除,2023年1月3日已经开始删除2023年1月1日上传的满足过期条件的对象,如果此时修改生命周期规则为7天过期删除,那么新规则不会对2023年1月1日上传的对象生效,2023年1月1日上传的对象会在2023年1月3日被删除完成,新的规则只会对2023年1月2日及以后上传的对象生效。
配置参数
通过API或SDK配置生命周期时,支持按照过期时间自动删除的配置,用户可以用XML格式进行配置,支持同时一个或多个生命周期规则。
具体配置参数如下:
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
LifecycleConfiguration | 是 | Array of Objects | 配置生命规则的信息 | LifecycleConfiguration |
表 LifecycleConfiguration
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
Rule | 是 | Array of Objects | 指定规则信息 | Rule |
表 Rule
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
ID | 是 | String | 规则ID | tst0718 | |
Filter | 否 | Array of Objects | 规则的适配范围,Tag和Prefix至少设置一个 | Filter | |
Status | 是 | String | 是否启用规则,Enabled:表示启用规则;Disabled:表示不启用规则 | Enabled | |
Expiration | 是 | Array of Objects | 指定规则的过期时间 | Expiration |
表 Filter
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
Tag | 否 | String | 指定规则所适用的对象标签,Tag和Prefix至少设置一个 | Tag | |
Prefix | 否 | String | 指定规则所适用的前缀,Tag和Prefix至少设置一个 | /testprefix |
表 Tag
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
Key | 否 | String | 指定规则所适用的标签键 | key1 | |
Value | 否 | String | 指定规则所适用的标签值 | val1 |
表 Expiration
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
Days | 是 | String | 指定具体天数,需要为数字 | 5 |
使用方式
支持的使用方式 | 参考文档 |
---|---|
控制台 | 可参考:生命周期。 |
SDK | 媒体存储支持多种语言SDK,请从SDK概览页面选择进入对应的开发指南查阅。 |
原生接口 | 可参考:生命周期。 |
OpenAPI | 可参考:生命周期。目前OpenAPI仅支持西藏资源池调用,如其他区域需通过API访问调用,请联系媒体存储技术团队。 |