设置桶的生命周期配置

Content-SHA256

是

String

参数解释：

消息体的SHA256摘要字符串，即消息体256bit SHA256值经过base64编码后得到的字符串。

示例：ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI=

取值范围：

不涉及

默认取值：

不涉及

LifecycleConfiguration

是

XML

参数解释：

生命周期配置规则。可以配置多条规则，LifecycleConfiguration是Rule的父节点。

约束限制：

整个配置消息体总大小不超过20KB。

取值范围：

不涉及

默认取值：

不涉及

Rule

是

XML

参数解释：

具体某一条生命周期配置。

约束限制：

不涉及

取值范围：

请详见Rule参数说明。

默认取值：

不涉及

Transition

如果没有NoncurrentVersionTransition, Expiration, NoncurrentVersionExpiration, AbortIncompleteMultipartUpload则必选

XML

参数解释：

生命周期配置中表示转换时间和转换后对象存储级别的元素。

约束限制：

仅针对对象的最新版本。

取值范围：

请详见Transition参数说明。

默认取值：

不涉及

Expiration

如果没有Transition, NoncurrentVersionTransition, NoncurrentVersionExpiration, AbortIncompleteMultipartUpload则必选

XML

参数解释：

在生命周期配置中表示过期时间。

约束限制：

仅针对对象的最新版本。

取值范围：

请详见Expiration参数说明。

默认取值：

不涉及

NoncurrentVersionTransition

如果没有Transition, Expiration, NoncurrentVersionExpiration, AbortIncompleteMultipartUpload则必选

XML

参数解释：

生命周期配置中表示转换时间和转换后对象存储级别的元素。

约束限制：

仅针对对象的历史版本。

取值范围：

请详见NoncurrentVersionTransition参数说明。

默认取值：

不涉及

NoncurrentVersionExpiration

否

XML

参数解释：

在生命周期配置中表示历史版本的过期时间。您可以将该动作设置在已启用多版本（或暂停）的桶，让系统删除对象的满足特定生命周期的历史版本。

约束限制：

仅针对历史版本。

取值范围：

请详见NoncurrentVersionExpiration参数说明

默认取值：

不涉及

AbortIncompleteMultipartUpload

如果没有Transition, Expiration, NoncurrentVersionExpiration, NoncurrentVersionTransition则必选

XML

参数解释：

未合并的多段任务（碎片）的过期属性。

约束限制：

不支持基于标签（Tag）的筛选条件。

取值范围：

请详见AbortIncompleteMultipartUpload参数说明。

默认取值：

不涉及

Filter

Rule的同级子节点，可以是Filter或者Prefix，二者只能选其一，不能同时出现。但是Prefix可以作为Filter的子节点。

XML

参数解释：

指定具体的匹配规则，生命周期将应用于桶内匹配到的对象。可以按照对象名前缀、对象标签或者二者的组合筛选对象。

约束限制：

Filter中如果包含多个筛选条件，需要使用逻辑AND组合筛选条件。

取值范围：

请详见Filter参数说明。

默认取值：

不涉及

ID

否

String

参数解释：

一条规则的标识。

约束限制：

只能由大写或小写的英文字母、数字、英文句号（.）、下划线（_）和连字符（-）组成。

取值范围：

长度为0~255的字符串。

默认取值：

不涉及

Prefix

是

String

参数解释：

对象名前缀，用来标识哪些对象可以匹配到当前规则。

约束限制：

• 当按前缀配置时，如果指定的前缀名与某条已配置的生命周期规则指定的前缀名存在包含关系，OBS会将两条规则视为同一条，而禁止您配置本条规则。例如，系统中已存在指定前缀名为“abc”的规则，则不允许再配置指定前缀以“abc”字段开头的规则。
• 如果已存在按前缀配置的生命周期规则，则不允许再新增配置到整个桶的规则。

取值范围：

长度为0~255的字符串。

默认取值：

不涉及

Status

是

String

参数解释：

标识当前规则是否启用。

约束限制：

不涉及

取值范围：

• Enabled：启用规则。
• Disabled：停用规则。

默认取值：

不涉及

Date

如果没有Days元素，则必选

String

参数解释：

指定OBS对该日期之前的对象执行生命周期规则。

约束限制：

日期格式必须为ISO8601的格式，并且为UTC的零点。 例如：2018-01-01T00:00:00.000Z，表示将最后修改时间早于2018-01-01T00:00:00.000Z的对象删除或转换成其他存储类型，等于或晚于这个时间的对象不会被删除或转储。

取值范围：

日期格式的字符串。

默认取值：

不涉及

Days

如果没有Date元素，则必选

Integer

参数解释：

指定生命周期规则在对象最后更新过后多少天生效。单位：天。

约束限制：

仅针对对象的最新版本。

取值范围：

取值为0~2147483647的数字。

默认取值：

不涉及

StorageClass

如果有Transition或NoncurrentVersionTransition元素，则必选

String

参数解释：

表示对象将被修改成的目标存储类别。

约束限制：

不涉及

取值范围：

• WARM：低频访问存储
• COLD：归档存储
• DEEP_ARCHIVE：深度归档存储

默认取值：

不涉及

Date

如果没有Days元素，则必选

String

参数解释：

指定OBS对该日期之前的对象执行生命周期规则。

约束限制：

日期格式必须为ISO8601的格式，并且为UTC的零点。 例如：2018-01-01T00:00:00.000Z，表示将最后修改时间早于2018-01-01T00:00:00.000Z的对象删除或转换成其他存储类型，等于或晚于这个时间的对象不会被删除或转储。

取值范围：

日期格式的字符串。

默认取值：

不涉及

Days

如果没有Date元素，则必选

Integer

参数解释：

指定生命周期规则在对象最后更新过后多少天生效。单位：天。

约束限制：

仅针对对象的最新版本。

取值范围：

取值为0~2147483647的数字。

默认取值：

不涉及

NoncurrentDays

如果有NoncurrentVersionExpiration或NoncurrentVersionTransition元素，则必选

Integer

参数解释：

表示对象在成为历史版本之后第几天时规则生效。单位：天。

约束限制：

仅针对历史版本。

取值范围：

• 仅设置一种转换：最少设置1天。
• 设置多种转换：后者时间要比前者时间最少长1天。
• 设置多种转换：针对同一个对象的历史版本转深度归档存储时间需要晚于转归档存储时间，转归档存储时间需要晚于转低频访问存储时间。

默认取值：

不涉及

StorageClass

如果有Transition或NoncurrentVersionTransition元素，则必选

String

参数解释：

表示对象将被修改成的目标存储类别。

约束限制：

不涉及

取值范围：

• WARM：低频访问存储
• COLD：归档存储
• DEEP_ARCHIVE：深度归档存储

默认取值：

不涉及

NoncurrentDays

如果有NoncurrentVersionExpiration或NoncurrentVersionTransition元素，则必选

Integer

参数解释：

表示对象在成为历史版本之后第几天时规则生效。单位：天。

约束限制：

仅针对历史版本。

取值范围：

取值为0~2147483647的数字。

默认取值：

不涉及

DaysAfterInitiation

如果有AbortIncompleteMultipartUpload则必选

Integer

参数解释：

指定生命周期规则在碎片生成后多久执行过期删除操作。单位：天。

约束限制：

不涉及

取值范围：

取值为0~2147483647的数字。

默认取值：

不涉及

And

存在Prefix和Tag的多条匹配规则时，则必选

XML

参数解释：

表示当前多条匹配规则逻辑且的关系。用于对象名前缀和对象标签二者的组合或多个对象标签组合来匹配对象。

约束限制：

• And的子节点不能为空。
• 当Fliter的子节点存在Tag或者Prefix时，And不能与之作为Fliter的同级别子节点共存。（Tag和Prefix可以包含在And中）。

取值范围：

请详见And参数说明。

默认取值：

不涉及

Tag

否

Container

参数解释：

对象标签，用以标识带有该标签的对象，可以匹配到当前规则。

约束限制：

• 存在于Filter的子节点时，只能存在1个Tag节点，如果Filter的同级子节点存在Prefix节点时则不能存在Tag节点。
• 存在于And的子节点时，只能存在最多10个Tag节点，且多个Tag之间的Key值不能相同。
• Rule的子节点内存在AbortIncompleteMultipartUpload时，不支持配置Tag对碎片进行筛选。
• 配置多条规则时，如果规则间的筛选条件存在标签重叠情况，且生命周期操作存在冲突时，将不允许配置。例如：规则1，指定标签为“Key等于key1，Value等于value1”的筛选条件，在对象创建90天后删除；规则2，指定标签为“Key等于key1，Value 等于value1”、“Key等于key2，Value 等于value2”的筛选条件，在对象创建120天后转为COLD存储类型。此时存在标签重叠和生命周期操作冲突的情况，将不被允许配置。

取值范围：

请详见Tag参数说明。

默认取值：

不涉及

Tag

否

Container

参数解释：

标签元素，用来标识哪些被打上该标签对象，可以匹配到当前规则。

约束限制：

• 存在于Filter的子节点时，只能存在1个Tag节点，如果Filter的同级子节点存在Prefix节点时则不能存在Tag节点。
• 存在于And的子节点时，只能存在最多10个Tag节点，且多个Tag之间的Key值不能相同。
• Rule的子节点内存在AbortIncompleteMultipartUpload时，不支持配置Tag对碎片进行筛选。
• 配置多条规则时，如果规则间的筛选条件存在标签重叠情况，且生命周期操作存在冲突时，将不允许配置。例如：规则1，指定标签为“Key等于key1，Value等于value1”的筛选条件，在对象创建90天后删除；规则2，指定标签为“Key等于key1，Value 等于value1”、“Key等于key2，Value 等于value2”的筛选条件，在对象创建120天后转为COLD存储类型。此时存在标签重叠和生命周期操作冲突的情况，将不被允许配置。

取值范围：

请详见Tag参数说明。

默认取值：

不涉及

Key

存在Tag时，则必选

String

参数解释：

Tag的键名。

约束限制：

不涉及

取值范围：

键名区分大小写且必须唯一，长度为0~128的字符串，不能为空，同时不允许使用“=”、“*”、“<”、“>”、“\”、“,”、“|”、“/”、“?”、“!”、“;”等字符。

默认取值：

不涉及

Value

存在Tag时，则必选

String

参数解释：

Tag的键值。

约束限制：

不涉及

取值范围：

键值区分大小写，长度为0~255的字符串，可以为空，同时不允许使用“=”、“*”、“<”、“>”、“\”、“,”、“|”、“?”、“!”、“;”等字符。

默认取值：

不涉及