Overview

COS introduces the lifecycle feature for you to manage the lifecycle of objects in buckets. The lifecycle configuration contains one or more rules that apply to a set of objects. Each rule defines one operation.
There are two types of operations:

• Transition: defines when an object is transitioned to another storage class. For example, you can transition an object to STANDARD_IA (suitable for infrequently accessed objects) 30 days after its creation. You can also transition the object to INTELLIGENT TIERING (suitable for objects with irregular access patterns) or ARCHIVE (offering lower costs). For specific parameters, please see Transition in the sample request description.
• Expiration: specifies when an object shall expire. COS will automatically delete expired objects.

Notes

This API is used to create a new lifecycle configuration for a bucket. If a lifecycle configuration has already been set for the bucket, the new configuration created with this API will overwrite the existing one.

Note：

• Days and Date cannot be both specified in the same lifecycle rule. Please pass them to two separate rules. For details, please see the following Sample.
• Up to 1,000 lifecycle rules can be added for each bucket.

Request

Sample request

PUT /?lifecycle HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Content-Length: length
Date: GMT Date
Authorization: Auth String 
Content-MD5: MD5

Note：

• In Host: <bucketname-appid>.cos.<region>.myqcloud.com, is the bucket name followed by the APPID, such as examplebucket-1250000000 (see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and is a COS region (see Regions and Access Endpoints).
• Authorization: Auth String (See Request Signature for details.)

Request headers

This API only uses Common Request Headers.

Request body

Nodes of the request body for this API are as follows:

<LifecycleConfiguration>
    <Rule>
          <ID></ID>
          <Filter>
                <And>
                      <Prefix></Prefix>
                      <Tag>
                            <Key></Key>
                            <Value></Value>
                      </Tag>
                </And>
          </Filter>
          <Status></Status>
          <Transition>
                <Days></Days>
                <StorageClass></StorageClass>
          </Transition>
          <NoncurrentVersionExpiration>
                <NoncurrentDays></NoncurrentDays>
          </NoncurrentVersionExpiration>
    </Rule>
    <Rule>
          <ID></ID>
          <Filter>
                <Prefix></Prefix>
          </Filter>
          <Status></Status>
          <Transition>
                <Days></Days>
                <StorageClass></StorageClass>
          </Transition>
          <NoncurrentVersionTransition>
                <NoncurrentDays></NoncurrentDays>
                <StorageClass></StorageClass>
          </NoncurrentVersionTransition>
    </Rule>
    <Rule>
          <ID></ID>
          <Filter>
                <Prefix></Prefix>
          </Filter>
          <Status></Status>
          <Expiration>
                <ExpiredObjectDeleteMarker></ExpiredObjectDeleteMarker>
          </Expiration>
          <NoncurrentVersionExpiration>
                <NoncurrentDays></NoncurrentDays>
          </NoncurrentVersionExpiration>
    </Rule>
</LifecycleConfiguration>

The nodes are described as follows:

Response

Response headers

This API only returns Common Response Headers.

Response body

The response body is empty.

Error codes

This API returns common error responses and error codes. For more information, please see Error Codes.

Samples

Request

PUT /?lifecycle HTTP/1.1
Host:examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 16 Aug 2017 11:59:33 GMT
Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1502855771;1502935771&q-key-time=1502855771;1502935771&q-header-list=content-md5;host&q-url-param-list=lifecycle&q-signature=f3aa2c708cfd8d4d36d658de56973c9cf1c2****
Content-MD5: LcNUuow8OSZMrEDnvndw1Q==
Content-Length: 348
Content-Type: application/x-www-form-urlencoded

<LifecycleConfiguration>
    <Rule>
          <ID>id1</ID>
          <Filter>
                <Prefix>documents/</Prefix>
          </Filter>
          <Status>Enabled</Status>
          <Transition>
                <Days>100</Days>
                <StorageClass>ARCHIVE</StorageClass>
          </Transition>
    </Rule>
    <Rule>
          <ID>id2</ID>
          <Filter>
                <Prefix>logs/</Prefix>
          </Filter>
          <Status>Enabled</Status>
          <Transition>
                <Days>10</Days>
                <StorageClass>STANDARD_IA</StorageClass>
          </Transition>
    </Rule>
</LifecycleConfiguration>

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Date: Wed, 16 Aug 2017 11:59:33 GMT
Server: tencent-cos
x-cos-request-id: NTk5NDMzYTRfMjQ4OGY3Xzc3NGRf****