生命周期元素说明-九游平台

规则元数据

id

元素解释：

规则id，id元素唯一地标识一条规则。

取值范围：

长度大于0且不超过255的字符串，只能由大写或小写的英文字母、数字、英文句号（.）、下划线（_）和连字符（-）组成。

默认取值：

如果未指定id元素或者该值为空时，obs会自动生成一个唯一id。

status

元素解释：

规则状态。如果规则处于禁用状态，则obs不会执行规则中指定的任何操作。

取值范围：

• enabled：规则启用
• disabled：规则禁用

默认取值：

无

规则的对象筛选条件

（filter）

prefix

元素解释：

对象名前缀，以指定前缀开头的对象可以匹配到当前规则。

如果您指定空的前缀，该规则将应用于桶中的所有对象。

约束限制：

• 每条生命周期规则必须有且只有一个prefix。如果无需使用对象名前缀过滤，字段值可置为空，即“”。
• 只有前缀筛选条件，不含对象标签筛选条件时，不写父节点filter。例如以下示例只筛选前缀为texta/的对象，没有对象标签筛选条件，不写filter父节点。

  1 2 3 4 5 6 7 8 9 10 11

  sample-rule texta/ enabled 100 cold

取值范围：

长度大于等于0且不超过1024的字符串。

默认取值：

如不指定，默认为空。

tag

元素解释：

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

约束限制：

• 删除碎片、删除过期删除标记不支持使用对象标签（tag）作为筛选条件。
• 单条生命周期规则中，对象标签的数量是0~10。
• 当筛选条件中指定多个标签时，每个标签的key必须唯一。
• 键名(key)约束：

1. 最大长度为128个字符，可用utf-8格式表示的字母（含中文）、数字、空格，以及以下字符：“_ . : = - @”。
2. 区分大小写，存在多条tag时，tag的键名(key)不能重复。
3. 不能为空。

• 键值（value）约束：

1. 最大长度为255个字符，可用utf-8格式表示的字母（含中文）、数字、空格，以及以下字符：“_ . : /= - @”。
2. 区分大小写。
3. 可以为空。

示例如下，规定对象标签键名为key1，键值为value1的对象，在最后一次修改后120天删除。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

sample-rule
enabled


key1
value1

120

默认取值：

如果不指定，默认为空。

prefix和tag组合使用

对象名前缀、对象标签二者组合筛选对象，此时需要使用逻辑and来组合筛选条件。and中可包含大于等于2个筛选条件，prefix是必选且只能有1个，tag是可选且最多可配置10个。

示例如下，规定对象标签键名为key1，键值为value1，且前缀为texta/的对象，在最后一次修改后120天删除。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

sample-rule
enabled


texta/

key1
value1

120

expiration

删除对象

days

（days、date和expiredobjectdeletemarker三选一）

元素解释：

指定生命周期规则在距离对象最后一次修改多少天后执行过期删除操作。

约束限制：

• 仅适用于对象的当前版本。
• 针对同一个对象过期删除时间需要晚于存储类别转换时间。

取值范围：

正整数，单位：天。

默认取值：

无

date

（days、date和expiredobjectdeletemarker三选一）

元素解释：

指定最后一次修改时间在该日期之前的对象执行删除对象操作。

约束限制：

• 仅适用于对象的当前版本。
• 日期格式必须为iso8601的格式，并且为utc的零点。 例如：2018-01-01t00:00:00.000z，表示将最后修改时间早于2018-01-01t00:00:00.000z的对象删除。
• 针对同一个对象过期删除时间需要晚于存储类别转换时间。
• 控制台和obs browser 暂不支持指定日期（date）删除的功能。

默认取值：

无

删除过期删除标记

expiredobjectdeletemarker

（days、date和expiredobjectdeletemarker三选一）

元素解释：

是否删除过期删除标记。

约束限制：

不支持使用对象标签（tag）作为筛选条件。

取值范围：

• true：删除过期删除标记
• false：不删除过期删除标记

默认取值：

无

transition

转换对象存储类别

days

（days与date二选一）

元素解释：

表示在对象在距离对象最后一次修改多少天后转换对象存储类别。

约束限制：

仅适用于对象的当前版本。

取值范围：

单位：天。

• 仅设置一种转换：最少设置1天。
• 设置多种转换：针对同一个对象转深度归档存储时间需要晚于转归档存储时间，转归档存储时间需要晚于转低频存储时间。

默认取值：

无

date

（days与date二选一）

元素解释：

指定最后一次修改时间在该日期之前的对象执行存储类别转换。

约束限制：

• 仅适用于对象的当前版本。
• 日期格式必须为iso8601的格式，并且为utc的零点。 例如：2018-01-01t00:00:00.000z，表示将最后修改时间早于2018-01-01t00:00:00.000z的对象转换存储类别。
• 设置多种转换：针对同一个对象转深度归档存储时间需要晚于转归档存储时间，转归档存储时间需要晚于转低频访问存储时间。
• 控制台和obs browser 暂不支持指定日期（date）转换存储类别的功能。

默认取值：

无

storageclass

元素解释：

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

取值范围：

• warm：低频访问存储
• cold：归档存储
• deep_archive：深度归档存储

默认取值：

无

abortincompletemultipartupload

清理碎片

daysafterinitiation

元素解释：

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

约束限制：

不支持使用对象标签（tag）作为筛选条件。

取值范围：

正整数，单位：天。

默认取值：

无

noncurrentversionexpiration

删除对象历史版本

noncurrentdays

元素解释：

表示对象版本在成为历史版本之后第几天时删除。

约束限制：

• 仅针对对象的历史版本。
• 当前桶已启用（或开启后暂停）多版本。
• 针对同一个对象的历史版本过期删除时间需要晚于存储类别转换时间。

取值范围：

正整数，单位：天。

默认取值：

无

noncurrentversiontransition

转换对象历史版本的存储类别

noncurrentdays

元素解释：

表示对象版本在成为历史版本之后第几天时转换对象。

约束限制：

• 仅针对对象的历史版本。
• 当前桶已启用（或开启后暂停）多版本。

取值范围：

单位：天。

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

默认取值：

无

storageclass

元素解释：

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

取值范围：

• warm：低频访问存储
• cold：归档存储
• deep_archive：深度归档存储

默认取值：

无