Amazon S3 GetBucketLifecycle API

Returns the lifecycle configuration information set on the bucket. For information about lifecycle configuration, see Object Lifecycle Management.

To use this operation, you must have permission to perform the s3:GetLifecycleConfiguration action. The bucket owner has this permission by default. The bucket owner can grant this permission to others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 Resources.

GetBucketLifecycle has the following special error:

The following operations are related to GetBucketLifecycle:

Request Syntax

GET /?lifecycle HTTP/1.1  
Host: Bucket.s3.amazonaws.com  
          

URI Request Parameters

The request uses the following URI parameters.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200  
<?xml version="1.0" encoding="UTF-8"?>  
<LifecycleConfiguration>     
<Rule>        
<AbortIncompleteMultipartUpload>           
<DaysAfterInitiation>integer</DaysAfterInitiation>        
</AbortIncompleteMultipartUpload>        
<Expiration>           
<Date>timestamp</Date>           
<Days>integer</Days>           
<ExpiredObjectDeleteMarker>boolean</ExpiredObjectDeleteMarker>        
</Expiration>        
<ID>string</ID>        
<NoncurrentVersionExpiration>           
<NoncurrentDays>integer</NoncurrentDays>        
</NoncurrentVersionExpiration>        
<NoncurrentVersionTransition>           
<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>
          

Response Elements

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

The following data is returned in XML format by the service.

Examples

Sample Request: Retrieve a lifecycle subresource

This example is a GET request to retrieve the lifecycle subresource from the specified bucket, and an example response with the returned lifecycle configuration.

GET /?lifecycle HTTP/1.1              
Host: examplebucket.s3.<Region>.amazonaws.com              
x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT              
Authorization: signatureValue           
          

Sample Response

HTTP/1.1 200 OK              
x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp              
x-amz-request-id: 51991C342C575321              
Date: Thu, 15 Nov 2012 00:17:23 GMT              
Server: AmazonS3              
Content-Length: 358                
<?xml version="1.0" encoding="UTF-8"?>              
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">                 
<Rule>                      
<ID>Archive and then delete rule</ID>                      
<Prefix>projectdocs/</Prefix>                     
<Status>Enabled</Status>                    
<Transition>                         
<Days>30</Days>                         
<StorageClass>STANDARD_IA</StorageClass>                    
</Transition>                    
<Transition>                       
<Days>365</Days>                        
<StorageClass>GLACIER</StorageClass>                     
</Transition>                     
<Expiration>                        
<Days>3650</Days>                     
</Expiration>                 
</Rule>              
</LifecycleConfiguration>