本文介绍对象(Object)生命周期基本示例中涉及的各个配置元素。

生命周期配置为XML格式,举例如下:

<LifecycleConfiguration>
<Rule>
 <ID>rule1</ID>
 <Prefix>logs/</Prefix>
 <Status>Enabled</Status>
 <Expiration>
   <Days>10</Days>
  </Expiration>
</Rule>
<Rule>
 <ID>rule2</ID>
 <Prefix>doc/</Prefix>
 <Status>Disabled</Status>
 <Expiration>
   <CreatedBeforeDate>2017-12-31T00:00:00.000Z</CreatedBeforeDate>
 </Expiration>
</Rule>
<Rule>
 <ID>rule3</ID>
 <Tag><Key>xx</Key><Value>1</Value></Tag>
 <Status>Enabled</Status>
 <Transition>
   <Days>60</Days>
   <StorageClass>Archive</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>        
上述示例中,有三条规则,含义如下:
  • 第一条规则会删除前缀为logs/,且最后更新时间是10天前的Object。
  • 第二条规则虽然指定了删除2017年12月31日之前被修改的前缀为doc/的Object,但是由于它的Status是Disabled状态,所以该规则并不会生效。
  • 第三条规则会将标签为xx=1,且最后更新时间是60天前的Object存储类型修改为Archive(归档存储)。

生命周期规则涉及的各项配置元素如ID元素、操作元素等将在下文提供详细介绍。

ID元素

为存储空间配置的生命周期规则ID。最多由255个字节组成。如没有指定,或者该值为空时,OSS会自动生成一个唯一ID。

Status元素

表示生命周期规则所处的状态。您可以选择启用(Enabled)或禁用(Disabled)生命周期规则。如果规则处于禁用状态,则OSS不会执行规则中定义的任何操作。

Prefix元素

基于您指定的<Prefix>元素,将生命周期规则应用于存储空间中的所有或部分Object。

时间元素

  • 按指定日期

    使用子元素<CreatedBeforeDate>指定绝对的日期,按照最后修改时间在该日期之前的Object,执行过期(Expiration)或转换(Transition)存储类型操作。

  • 按指定天数

    使用子元素<Days>指定相对天数,并指定Object在其最后修改时间的N天后,执行过期或转换存储类型操作。

操作元素

通过在生命周期规则中指定的一个或多个操作元素,您可以指示OSS在Object的生命周期内执行特定操作。这些操作的效果取决于存储桶的版本控制状态。以下总结了Object执行的生命周期配置规则操作的行为与包含Object的存储空间的版本控制状态的关系。

  • 未开启版本控制的Bucket
    操作 说明
    Transition 达到Object生命周期中指定的日期或时间段时,将Object转换为指定存储类型(StorageClass)。有关生命周期支持转换的存储类型的更多信息,请参见通过生命周期规则自动转换Object的存储类型
    Expiration 达到Object生命周期中指定的日期或时间段时,永久删除符合条件的Object。
  • 受版本控制的Bucket

    对受版本控制(即已开启或暂停版本控制)的Bucket中Object生命周期的相关元素说明如下:

    • 当前版本Object过期或转换操作
      操作 说明
      Expiration 根据当前版本Object是否为删除标记,其过期行为说明如下:
      • 当前版本Object不为删除标记:
        • 在开启版本控制状态下,OSS将会插入具有唯一版本ID的删除标记作为当前版本,原当前版本将成为非当前版本。
        • 在暂停版本控制状态下,OSS将会插入null版本ID的删除标记作为当前版本,而原当前版本中版本ID为null的版本将被覆盖,以保证一个Object只有一个版本ID为null的版本。
      • 当前版本Object为删除标记:
        • 且在该Object还有一个或多个非当前版本状态下进行Expiration过期操作,OSS将不执行任何操作。
        • 且在该Object仅有一个版本的状态下,进行Expiration过期操作或者将Expiration规则的子元素ExpiredObjectDeleteMarker的值设置为true,OSS都将自动移除该删除标记。
          注意
          • Object当前版本经过生命周期、或主动发起的非指定版本的删除操作时,当前版本将被置为非当前版本。所有非当前版本Object经过生命周期、或主动发起的指定版本的删除操作后均被永久删除,此时仅剩下唯一的删除标记作为当前版本,即过期删除标记。
          • 子元素ExpiredObjectDeleteMarker不能与标签规则同时配置。
      Transition 达到生命周期中指定的日期或时间段时,将当前版本Object转换为指定存储类型。
    • 非当前版本Object过期或转换操作
      操作 说明 关联的子元素
      NoncurrentVersionExpiration 非当前版本过期操作。 子元素<NoncurrentDays>指相对过期时间,表示该版本从当前版本变成非当前版本开始,到永久删除之间的保留时间段。
      说明 例如该版本原本为当前版本,2019年5月1日由于PutObject覆盖操作,该版本变成了非当前版本。NoncurrentVersionExpiration元素设置了<NoncurrentDays>过期时间为3天,那么该版本将在2019年5月4日被彻底删除。由于版本的连续性,每次执行上传操作时,当前版本会被置为第一个非当前版本,新添加的版本成为其后继版本。OSS会通过查看其后继版本的创建时间,来获取一个版本成为非当前版本的开始时间。
      NoncurrentVersionTransition 非当前版本Object存储类型转换操作。
      • 子元素< NoncurrentDays>指相对转换时间,表示该版本从当前版本变成非当前版本开始,到进行存储类型转换之间的时间段。
      • 子元素<StorageClass>用来指定Object转储的存储类型。