Object Storage Service:lifecycle

Example 1: Expire objects and transition by prefix

The following configuration contains two rules. The first rule (test-rule1) applies to all objects in examplebucket (Prefix is empty) and expires them 365 days after their last modification. The second rule (test-rule2) applies to objects with the test/ prefix and transitions them to the Archive storage class 30 days after their last modification.

1. Create a file named localfile.xml with the following content:

      <?xml version="1.0" encoding="UTF-8"?>
      <LifecycleConfiguration>
        <Rule>
          <ID>test-rule1</ID>
          <Prefix></Prefix>
          <Status>Enabled</Status>
          <Expiration>
            <Days>365</Days>
          </Expiration>
        </Rule>
        <Rule>
          <ID>test-rule2</ID>
          <Prefix>test/</Prefix>
          <Status>Enabled</Status>
          <Transition>
            <Days>30</Days>
            <StorageClass>Archive</StorageClass>
          </Transition>
        </Rule>
      </LifecycleConfiguration>

2. Run the following command to apply the configuration to examplebucket: If the command succeeds, the output shows the elapsed time:

      ossutil lifecycle --method put oss://examplebucket localfile.xml

      0.299514(s) elapsed

Example 2: Expire objects by date

The following rule expires all objects in examplebucket whose last modified time is earlier than December 30, 2019.

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>test-rule0</ID>
    <Prefix></Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <CreatedBeforeDate>2019-12-30T00:00:00.000Z</CreatedBeforeDate>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Example 3: Manage current and noncurrent object versions

For a versioning-enabled bucket named examplebucket, the following rule performs three actions on all objects:

• Transitions current object versions to the Infrequent Access (IA) storage class 10 days after their last modification.

• Transitions noncurrent object versions to the Archive storage class 60 days after they become noncurrent.

• Deletes noncurrent object versions 90 days after they become noncurrent.

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>test-rule3</ID>
    <Prefix></Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>10</Days>
      <StorageClass>IA</StorageClass>
    </Transition>
    <NoncurrentVersionTransition>
      <NoncurrentDays>60</NoncurrentDays>
      <StorageClass>Archive</StorageClass>
    </NoncurrentVersionTransition>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>90</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
</LifecycleConfiguration>

Example 4: Transition based on last access time

The following rule applies to objects with the data/ prefix. It transitions these objects to the IA storage class 200 days after they were last accessed. Because ReturnToStdWhenVisit is set to false, the objects remain in the IA storage class even if accessed again.

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>test-rule4</ID>
    <Prefix>data/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>200</Days>
      <StorageClass>IA</StorageClass>
      <IsAccessTime>true</IsAccessTime>
      <ReturnToStdWhenVisit>false</ReturnToStdWhenVisit>
    </Transition>
  </Rule>
</LifecycleConfiguration>