S3 Bucket Versions Operations:Get Bucket Versions

Search (SHIFT+S)




Get Bucket Versions

GET /?versions

List object versions of a bucket

URL Format

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

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 then you must specify either the x-amz-date or the Date header. If both the headers are specified then 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.

  • The user must have READ access to this 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
<Version>
<Key> The key of the object String
<VersionId> The version ID of the object String
<IsLatest> Indicates whether this version is the latest one for object Boolean Valid Values:
  •  true = latest version
  •  false = not the latest version
<LastModified> Timestamp of the last time the object was modified Date Valid Values:
  •  Date in ISO 8601 format
<ETag> The entity tag is an object's MD5 hash. This only reflects changes to the contents of an object String
<Size> Size of the objects in bytes Long
<Owner>    
<ID> The ID of the bucket owner String
<DisplayName> Screen name of the owner of the bucket. String
</Owner>      
<StorageClass> The class of storage String Valid Values:
  •  STANDARD
</Version>
Notes: