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 |
See signed URL query string parameters for information on the parameters you include when creating and using signed URLs.
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_NAME.storage.googleapis.com Date: DATE Content-Length: 0 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. |