GET Bucket Versioning
The GET Bucket Versioning operation returns the versioning state of a bucket. To retrieve the versioning state of a bucket, you must be the bucket owner. The following versioning states apply to this operation:
-
When versioning is enabled on a bucket, the response is as follows:
<VersioningConfiguration> <Status>Enabled</Status> </VersioningConfiguration>
-
When versioning is suspended on a bucket, the response is as follows:
<VersioningConfiguration> <Status>Suspended</Status> </VersioningConfiguration>
-
When versioning is not enabled or suspended on a bucket, the response is as follows:
<VersioningConfiguration/>
Request Parameters
The GET Bucket Versioning operation does not support the use of request parameters.
Request Headers
The GET Bucket Versioning operation uses only request headers that are common to all operations. For more information, see table "Common Supported Request Headers" in Supported Common Request Headers.
Response Headers
The GET Bucket Versioning operation uses only response headers that are common to most responses. For more information, see table "Supported Response Headers" in Supported Common Response Headers.
Response Elements
The following XML response elements are supported:
-
Status
-
VersioningConfiguration
For a detailed description of these response elements, see GET Bucket versioning.
Error Response Code
The GET Bucket Versioning operations does not support errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.