Cloud Enterprise Object Storage REST API

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 owner String
DisplayName Screen name of the owner. String
StorageClass The class of storage String Valid Values:
  •  STANDARD