Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle configuration. For information about lifecycle configuration, seeObject Lifecycle Management in theAmazon S3 User Guide.

By default, all Amazon S3 resources, including buckets, objects, and related subresources (for example, lifecycle configuration and website configuration) are private. Only the resource owner, the AWS account that created the resource, can access it. The resource owner can optionally grant access permissions to others by writing an access policy. For this operation, users must get thes3:PutLifecycleConfiguration permission.

You can also explicitly deny permissions. Explicit denial also supersedes any other permissions. If you want to prevent users or accounts from removing or deleting objects from your bucket, you must deny them permissions for the following actions:

For more information about permissions, seeManaging Access Permissions to your Amazon S3 Resources in theAmazon S3 User Guide.

For more examples of transitioning objects to storage classes such as STANDARD_IA or ONEZONE_IA, seeExamples of Lifecycle Configuration.

The following operations are related toPutBucketLifecycle:

Request Syntax

PUT /?lifecycle HTTP/1.1Host:Bucket.s3.amazonaws.comContent-MD5:ContentMD5x-amz-sdk-checksum-algorithm:ChecksumAlgorithmx-amz-expected-bucket-owner:ExpectedBucketOwner<?xml version="1.0" encoding="UTF-8"?><LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <Rule>      <AbortIncompleteMultipartUpload>         <DaysAfterInitiation>integer</DaysAfterInitiation>      </AbortIncompleteMultipartUpload>      <Expiration>         <Date>timestamp</Date>         <Days>integer</Days>         <ExpiredObjectDeleteMarker>boolean</ExpiredObjectDeleteMarker>      </Expiration>      <ID>string</ID>      <NoncurrentVersionExpiration>         <NewerNoncurrentVersions>integer</NewerNoncurrentVersions>         <NoncurrentDays>integer</NoncurrentDays>      </NoncurrentVersionExpiration>      <NoncurrentVersionTransition>         <NewerNoncurrentVersions>integer</NewerNoncurrentVersions>         <NoncurrentDays>integer</NoncurrentDays>         <StorageClass>string</StorageClass>      </NoncurrentVersionTransition>      <Prefix>string</Prefix>      <Status>string</Status>      <Transition>         <Date>timestamp</Date>         <Days>integer</Days>         <StorageClass>string</StorageClass>      </Transition>   </Rule>   ...</LifecycleConfiguration>

URI Request Parameters

The request uses the following URI parameters.

Request Body

The request accepts the following data in XML format.

Response Syntax

HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Examples

Sample Request: Body of a basic lifecycle configuration

In the request, you specify the lifecycle configuration in the request body. The lifecycle configuration is specified as XML. The following is an example of a basic lifecycle configuration. It specifies one rule. ThePrefix in the rule identifies objects to which the rule applies. The rule also specifies two actions (Transition andExpiration). Each action specifies a time line when Amazon S3 should perform the action. The Status indicates whether the rule is enabled or disabled.

<LifecycleConfiguration>    <Rule>        <ID>sample-rule</ID>        <Prefix>key-prefix</Prefix>        <Status>rule-status</Status>        <Transition>                   <Date>value</Date>                   <StorageClass>storage class</StorageClass>               </Transition>            <Expiration>           <Days>value</Days>        </Expiration>    </Rule></LifecycleConfiguration>

Sample Request: Body of a lifecycle configuration specifying noncurrent versions

If the state of your bucket is versioning-enabled or versioning-suspended, you can have many versions of the same object: one current version and zero or more noncurrent versions. The following lifecycle configuration specifies the actions (NoncurrentVersionTransition,NoncurrentVersionExpiration) that are specific to noncurrent object versions.

<LifecycleConfiguration>    <Rule>        <ID>sample-rule</ID>        <Prefix>key-prefix</Prefix>        <Status>rule-status</Status>        <NoncurrentVersionTransition>                   <NoncurrentDays>value</NoncurrentDays>                   <StorageClass>storage class</StorageClass>               </NoncurrentVersionTransition>            <NoncurrentVersionExpiration>           <NoncurrentDays>value</NoncurrentDays>        </NoncurrentVersionExpiration>    </Rule></LifecycleConfiguration>

Sample Request: Body of a lifecycle configuration that specifies a rule with AbortIncompleteMultipartUpload

You can use the multipart upload to upload large objects in parts. For more information about multipart uploads, seeMultipart Upload Overview in theAmazon S3 User Guide. With lifecycle configuration, you can tell Amazon S3 to abort incomplete multipart uploads, which are identified by the key name prefix specified in the rule, if they don't complete within a specified number of days. When Amazon S3 aborts a multipart upload, it deletes all parts associated with the upload. This ensures that you don't have incomplete multipart uploads that have left parts stored in Amazon S3, so you don't have to pay storage costs for them. The following is an example lifecycle configuration that specifies a rule with theAbortIncompleteMultipartUpload action. This action tells Amazon S3 to abort incomplete multipart uploads seven days after initiation.

<LifecycleConfiguration>    <Rule>        <ID>sample-rule</ID>        <Prefix>SomeKeyPrefix</Prefix>        <Status>rule-status</Status>        <AbortIncompleteMultipartUpload>                   <DaysAfterInitiation>7</DaysAfterInitiation>                </AbortIncompleteMultipartUpload>        </Rule></LifecycleConfiguration>

Add lifecycle configuration to a bucket that is not versioning-enabled

The following is a samplePUT /?lifecycle request that adds the lifecycle configuration to theexamplebucket bucket. The lifecycle configuration specifies two rules, each with one action:

The sample response follows the sample request.

PUT /?lifecycle HTTP/1.1Host: examplebucket.s3.<Region>.amazonaws.com x-amz-date: Wed, 14 May 2014 02:11:21 GMTContent-MD5: q6yJDlIkcBaGGfb3QLY69A==Authorization: authorization stringContent-Length: 415<LifecycleConfiguration>  <Rule>    <ID>id1</ID>    <Prefix>documents/</Prefix>    <Status>Enabled</Status>    <Transition>      <Days>30</Days>      <StorageClass>GLACIER</StorageClass>    </Transition>  </Rule>  <Rule>    <ID>id2</ID>    <Prefix>logs/</Prefix>    <Status>Enabled</Status>    <Expiration>      <Days>365</Days>    </Expiration>  </Rule></LifecycleConfiguration>

HTTP/1.1 200 OKx-amz-id-2: r+qR7+nhXtJDDIJ0JJYcd+1j5nM/rUFiiiZ/fNbDOsd3JUE8NWMLNHXmvPfwMpdcx-amz-request-id: 9E26D08072A8EF9EDate: Wed, 14 May 2014 02:11:22 GMTContent-Length: 0Server: AmazonS3

Add lifecycle configuration to a bucket that is versioning-enabled

The following is a sample PUT /?lifecycle request that adds the lifecycle configuration to theexamplebucket bucket. The lifecycle configuration specifies two rules, each with one action. You specify these actions when your bucket is versioning-enabled or versioning is suspended:

The sample response follows the sample request.

PUT /?lifecycle HTTP/1.1Host: examplebucket.s3.<Region>.amazonaws.com x-amz-date: Wed, 14 May 2014 02:21:48 GMTContent-MD5: 96rxH9mDqVNKkaZDddgnw==Authorization: authorization stringContent-Length: 598<LifecycleConfiguration>  <Rule>    <ID>id1</ID>    <Prefix>logs/</Prefix>    <Status>Enabled</Status>    <NoncurrentVersionExpiration>      <NoncurrentDays>1</NoncurrentDays>    </NoncurrentVersionExpiration>  </Rule>  <Rule>    <ID>TransitionSoonAfterBecomingNonCurrent</ID>    <Prefix>documents/</Prefix>    <Status>Enabled</Status>    <NoncurrentVersionTransition>      <NoncurrentDays>0</NoncurrentDays>      <StorageClass>GLACIER</StorageClass>    </NoncurrentVersionTransition>  </Rule></LifecycleConfiguration>

HTTP/1.1 200 OKx-amz-id-2: aXQ+KbIrmMmoO//3bMdDTw/CnjArwje+J49Hf+j44yRb/VmbIkgIO5A+PT98Cp/6k07hf+LD2mY=x-amz-request-id: 02D7EC4C10381EB1Date: Wed, 14 May 2014 02:21:50 GMTContent-Length: 0Server: AmazonS3

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

Thanks for letting us know we're doing a good job!

If you've got a moment, please tell us what we did right so we can do more of it.

Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.