S3 Bucket Lifecycle Operation:Get Bucket Lifecycle

Search (SHIFT+S)




Get Bucket Lifecycle

GET /?lifecycle

Retrieves the lifecycle configuration for the bucket

URL Format

Host Style: http://bucketname.ns1.emc.com/?lifecycle
Path Style: http://ns1.emc.com/bucketname?lifecycle

Request Headers

x-amz-date optionalThe timestamp of the request added by the requester. Example: Tue, 03 Sept 2013 12:00:00 GMT. If the Authorization header is specified, you must specify either the x-amz-date or the Date header. If both the headers are specified, the value of x-amz-date header is chosen.
Authorization requiredInformation needed to authenticate requests.

Prerequisites

The following conditions must be met in order to call this operation.

  • Only the owner of the bucket or a user having permission can retrieve lifecycle configuration for the bucket

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace corresponding to this bucket should exist (for example, ns1)


Response Body

Field Description Type Notes
<LifecycleConfiguration>
<Rule>     0-* Elements
<ID> The rule's unique identifier String Valid Values:
  •  value is less than or equal to 255 characters
<Prefix> Objects having the key prefix, to which the rule should apply String
<Status> Indicates whether to enable or disable this rule. If disabled, this rule is ignored String Valid Values:
  •  Disabled
  •  Enabled
<Expiration>    
<Days> Indicates the number of days after the creation of the object when this rule should take effect String Valid Values:
  •  A non-negative integer value
<Date> The date when the rule must be applied String Valid Values:
  •  value conforming to ISO 8601 format
</Expiration>      
</Rule>      
</LifecycleConfiguration>
Notes: