Bucket object lifecycle configuration

To pass a lifecycle configuration through the HTTP API compatible with Amazon S3, it should be formatted as an XML document of the following type:

<LifecycleConfiguration>
    <Rule>
        <Status>{Enabled|Disabled}</Status>
        <Filter>
           <Prefix>key_ prefix</Prefix>
        </Filter>
        <Expiration>
            <!-- <Date> or <Days> -->
        </Expiration>
        ...
    </Rule>
    <Rule>
      ...
    </Rule>
    …
</LifecycleConfiguration>

A configuration can contain up to 1,000 rules.

Possible elements

Element Description
Date Date on which Object Storage will perform an action.

It must be in ISO 8601 format such as YYYY-MM-DD. Time: always 00:00 UTC.

Path: LifecycleConfiguration\Rule\Expiration\Date.
Days Determines the number of days after loading an object when the rule becomes applicable.

Path: LifecycleConfiguration\Rule\Expiration\Days.
Expiration Contains the <Days> and/or <Date> elements that determine when to delete an object from Object Storage.

Path: LifecycleConfiguration\Rule\Expiration.
Filter Contains no more than one Prefix element.

If an empty <Filter></Filter> is set, the rule will apply to all bucket elements.

Path: LifecycleConfiguration\Rule\Filter.
ID Unique rule ID.

The maximum ID length is 255 characters. Optional parameter. You can use it to search for a rule in a configuration.

Path: LifecycleConfiguration\Rule\ID.
LifecycleConfiguration Root element of an XML document. It can contain up to 1,000 elements <Rule>.

Path: LifecycleConfiguration.
Prefix Prefix of the key that is used for object filtering when applying the rule.
For example, you can use any prefix for the some/long/object/key key, regardless of where slashes are placed in its name. In other words, when using any of the prefixes some, some/, or some/long/obj, the some/long/object/key key will match the rule.

A filter may have only one prefix.

Path:LifecycleConfiguration\Rule\Filter\Prefix.
Rule Contains a description of a single rule.

Path: LifecycleConfiguration\Rule.
Status You can activate a rule by setting <Status>Enabled</Status> or deactivate it by setting <Status>Disabled</Status>.

Path: LifecycleConfiguration\Rule\Status.