Get Bucket Versioning

To get a bucket's versioning configuration you make a GET request that is scoped to a bucket and you use the versioning query string parameter. The versioning configuration is returned in an XML document in the response body.

Query string parameters

Parameter Description Required
versioning You can use this to display the versioning configuration of an existing bucket. No

Request headers

See common request headers.

Request body elements

This request does not include an XML document in the request body.

Request syntax

The following syntax applies to GET Bucket requests that use the versioning query string parameter.

GET /?versioning HTTP/1.1
Host: <bucket>
Date: <date>
Content-Length: <request body length>
Authorization: <authentication string>

Response headers

The request can return a variety of response headers depending on the request headers you use.

Response body elements

The following response body elements are applicable only if you use the versioning query string parameter to display bucket's object versioning configuration.

Element Description
VersioningConfiguration Container for versioning configuration. Empty element if versioning has not been enabled for the bucket.
Status Status of versioning for this bucket. Currently either Enabled or Suspended.
Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Storage
Need help? Visit our support page.