S3 Bucket Versioning Operations:Get Bucket Versioning

Search (SHIFT+S)

Get Bucket Versioning

GET /?versioning

Returns the versioning state of a bucket.

URL Format

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

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.


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

  • Only the bucket owner can retrieve the versioning state of a 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
<Status> Versioning state of the bucket String Valid Values:
  •  Suspended = Disable versioning for the bucket
  •  Enabled = Enable versioning for the bucket