Object Storage Service:PutBucketLifecycle

Usage notes

• To configure a lifecycle rule for a bucket, you must have the oss:PutBucketLifecycle permission. For more information, see Attach a custom policy to a RAM user.
• The PutBucketLifecycle operation overwrites the existing configurations of a lifecycle rule that is configured for a bucket. For example, if a lifecycle rule named Rule1 is configured for a bucket and you want to configure a lifecycle rule named Rule2 for the bucket based on Rule1, perform the following operations:
  1. Call the GetBucketLifecycle operation to query Rule1.
  2. Rule2 is configured for the bucket based on Rule1.
  3. Call the PutBucketLifecycle operation to update the lifecycle rule configurations of the bucket. Rule1 and Rule2 are configured for the bucket.
• You can use lifecycle rules to specify the expiration time of objects and parts that are uploaded in incomplete multipart upload tasks.
• You can configure a lifecycle rule for objects based on their last access time or last modified time.

Request syntax

PUT /?lifecycle HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Authorization: SignatureValue 
Host: BucketName.oss.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>RuleID</ID>
    <Prefix>Prefix</Prefix>
    <Status>Status</Status>
    <Expiration>
      <Days>Days</Days>
    </Expiration>
    <Transition>
      <Days>Days</Days>
      <StorageClass>StorageClass</StorageClass>
    </Transition>
    <AbortMultipartUpload>
      <Days>Days</Days>
    </AbortMultipartUpload>
  </Rule>
</LifecycleConfiguration>

Request headers

This request contains only common request headers. For more information, see Common request headers.

Request parameters

Response headers

This request contains only common response headers. For more information, see Common response headers.

Examples

• Sample requests
  • Example 1: Configure a lifecycle rule based on the last modified time to only convert the storage class of objects

    The following code provides an example on how to configure a lifecycle rule to only convert the storage class of objects whose names contain the log prefix in the bucket to IA 30 days after the objects are last modified:

    PUT /?lifecycle HTTP/1.1
    Host: oss-example.oss.aliyuncs.com
    Content-Length: 336
    Date: Mon , 6 May 2019 15:23:20 GMT
    Authorization: OSSWnjl3fg9fdv8fg4b****:Phuu8bBhS8dsff2a****
    <?xml version="1.0" encoding="UTF-8"?>
    <LifecycleConfiguration>
      <Rule>
        <ID>rule</ID>
        <Prefix>log/</Prefix>
        <Status>Enabled</Status>
        <Transition>
          <Days>30</Days>
          <StorageClass>IA</StorageClass>
        </Transition>    
      </Rule>
    </LifecycleConfiguration>

  • Example 2: Configure a lifecycle rule based on the last modified time to only delete objects

    The following code provides an example on how to configure a lifecycle rule to only delete objects whose names contain the log prefix in the bucket 90 days after the objects are last modified:

    PUT /?lifecycle HTTP/1.1
    Host: oss-example.oss.aliyuncs.com
    Content-Length: 336
    Date: Mon , 6 May 2019 15:23:20 GMT
    Authorization: OSSWnjl3fg9fdv8fg4b****:Phuu8bBhS8dsff2a****
    <?xml version="1.0" encoding="UTF-8"?>
    <LifecycleConfiguration>
      <Rule>
        <ID>rule</ID>
        <Prefix>log/</Prefix>
        <Status>Enabled</Status>
        <Expiration>
          <Days>90</Days>
        </Expiration>    
     </Rule>
    </LifecycleConfiguration>

  • Example 3: Configure a lifecycle rule based on the last modified time to convert the storage class of objects and delete objects

    The following code provides an example on how to configure a lifecycle rule to convert the storage class of objects whose names contain the log prefix in the bucket to IA 30 days after the objects are last modified, covert the storage class of the IA objects to Archive after 60 days, and delete the Archive objects after 3600 days:

    PUT /?lifecycle HTTP/1.1
    Host: oss-example.oss.aliyuncs.com
    Content-Length: 336
    Date: Mon , 6 May 2019 15:23:20 GMT
    Authorization: OSSWnjl3fg9fdv8fg4b****:Phuu8bBhS8dsff2a****
    <?xml version="1.0" encoding="UTF-8"?>
    <LifecycleConfiguration>
      <Rule>
        <ID>rule</ID>
        <Prefix>log/</Prefix>
        <Status>Enabled</Status>
        <Transition>
          <Days>30</Days>
          <StorageClass>IA</StorageClass>
        </Transition>
        <Transition>
          <Days>60</Days>
          <StorageClass>Archive</StorageClass>
        </Transition>
        <Expiration>
          <Days>3600</Days>
        </Expiration>
      </Rule>
    </LifecycleConfiguration>

  • Example 4: Configure a lifecycle rule based on the last modified time to delete previous versions of objects and remove delete markers

    The following code provides an example on how to configure a lifecycle rule to delete previous versions of objects five days after they become previous versions and remove delete markers:

    PUT /?lifecycle HTTP/1.1
    Host: oss-example.oss.aliyuncs.com
    Content-Length: 336
    Date: Mon , 6 May 2019 15:23:20 GMT
    Authorization: OSSWnjl3fg9fdv8fg4b****:Phuu8bBhS8dsff2a****
    <?xml version="1.0" encoding="UTF-8"?>
    <LifecycleConfiguration>
      <Rule>
        <ID>rule</ID>
        <Prefix></Prefix>
        <Status>Enabled</Status>
        <Expiration>
          <ExpiredObjectDeleteMarker>true</ExpiredObjectDeleteMarker>
        </Expiration>
        <NoncurrentVersionExpiration>
          <NoncurrentDays>5</NoncurrentDays>
        </NoncurrentVersionExpiration>    
      </Rule>
    </LifecycleConfiguration>

  • Example 5: Configure a lifecycle rule based on the last modified time to convert the storage class of objects and delete objects, except for objects whose names contain specific prefixes or that have specific tags

    The following code provides an example on how to configure a lifecycle rule based on the last modified time. The lifecycle rule is used to convert the storage class of objects that meet the following conditions in the bucket to Archive 30 days after the objects are last modified and delete the objects after 100 days: The names of the objects do not contain the log prefix and the objects whose key is key1 and whose value is value1. The Not element in the filter node is used to specify the log prefix, the key1 key, and the value1 value.

    PUT /?lifecycle HTTP/1.1
    Host: oss-example.oss.aliyuncs.com
    Content-Length: 336
    Date: Mon , 6 May 2019 15:23:20 GMT
    Authorization: OSSWnjl3fg9fdv8fg4b****:Phuu8bBhS8dsff2a****
    <?xml version="1.0" encoding="UTF-8"?>
    <LifecycleConfiguration>
      <Rule>
        <ID>rule</ID>
        <Prefix></Prefix>
        <Status>Enabled</Status>
        <Filter>
          <Not>
            <Prefix>log</Prefix>
            <Tag><Key>key1</Key><Value>value1</Value></Tag>
          </Not>
        </Filter>    
        <Transition>
          <Days>30</Days>
          <StorageClass>Archive</StorageClass>
        </Transition>
        <Expiration>
          <Days>100</Days>
        </Expiration>
      </Rule>
    </LifecycleConfiguration>

  • Example 6: Configure a lifecycle rule based on the last access time to convert the storage class of objects

    The following code provides an example on how to configure a lifecycle rule to convert the objects whose names contain the log prefix to IA 30 days after the objects are last accessed. In addition, specify that the storage class of the objects is converted to Standard when the objects are accessed again.

    PUT /?lifecycle HTTP/1.1
    Host: oss-example.oss.aliyuncs.com
    Content-Length: 336
    Date: Mon , 6 May 2019 15:23:20 GMT
    Authorization: OSSWnjl3fg9fdv8fg4b****:Phuu8bBhS8dsff2a****
    <?xml version="1.0" encoding="UTF-8"?>
    <LifecycleConfiguration>
      <Rule>
        <ID>rule</ID>
        <Prefix>log/</Prefix>
        <Status>Enabled</Status>
        <Transition>
          <Days>30</Days>
          <StorageClass>IA</StorageClass>
          <IsAccessTime>true</IsAccessTime>
          <ReturnToStdWhenVisit>true</ReturnToStdWhenVisit>
        </Transition>
      </Rule>
    </LifecycleConfiguration>

  • Example 7: Configure a lifecycle rule to delete parts

    The following code provides an example on how to configure a lifecycle rule to delete parts that are generated in a bucket earlier than 30 days:

    PUT /?lifecycle HTTP/1.1
    Host: oss-example.oss.aliyuncs.com
    Content-Length: 336
    Date: Mon , 6 May 2019 15:23:20 GMT
    Authorization: OSSWnjl3fg9fdv8fg4b****:Phuu8bBhS8dsff2a****
    <?xml version="1.0" encoding="UTF-8"?>
    <LifecycleConfiguration>
      <Rule>
        <ID>rule</ID>
        <Prefix>/</Prefix>
        <Status>Enabled</Status>    
        <AbortMultipartUpload>
          <Days>30</Days>
        </AbortMultipartUpload>
     </Rule>
    </LifecycleConfiguration>

• Sample responses

  HTTP/1.1 200 OK
  x-oss-request-id: 7D3435J59A9812BAD56E
  Date: Mon , 6 May 2019 15:23:20 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

OSS SDKs

You can use OSS SDKs for the following programming languages to call the GetBucketLifecycle operation:

• Java
• Python
• PHP
• Go
• C
• C++
• .NET
• Android
• Node.js
• Ruby

Error codes