Manage lifecycle rules

OSS allows you to set lifecycle rules for buckets to automatically remove expired objects and save the storage space. You can set multiple lifecycle rules. A lifecycle rule contains the following:

• Rule ID: It is used to identify the rule and cannot be repeated.

• Prefix of objects subject to the rule: The rule is only applicable to the objects with the specified prefix.

• Expiration time: It can be specified in either of the following ways:

  • Specifying that the object expires on the Nth day after the last modification
  • Specifying that the object expires on a specific day. It means that all objects with the specified prefix expires after the day, regardless of the last modification time of the objects. This method is not recommended.

• Take effect or not

For more information, see Manage object lifecycle.

Set lifecycle rules

The following code uses Bucket#lifecycle= to configure lifecycle rules:

require 'aliyun/oss'
client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
bucket.lifecycle = [
  LifeCycleRule.new(
    :id => 'rule1', :enabled => true, :prefix => 'foo/', :expiry => 3),
  LifeCycleRule.new(
    :id => 'rule2', :enabled => false, :prefix => 'bar/', :expiry => Date.new(2016, 1, 1))
]

View lifecycle rules

The following code uses Bucket#lifecycle to display lifecycle rules:

require 'aliyun/oss'
client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
rules = bucket.lifecycle
puts rules

Clear lifecycle rules

The following code uses Bucket#lifecycle= to configure an empty rule array for clearing lifecycle rules:

require 'aliyun/oss'
client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
bucket.lifecycle = []