GET Bucket Versioning

The owner of a bucket can use this operation to get the versioning state of the bucket.

If versioning is not configured for a bucket, no versioning state information will be returned after this operation.

Request Syntax

GET /?versioning HTTP/1.1
Date: date
Authorization: authorization

Request Parameters

This request contains no parameter.

Request Headers

This request uses common headers. For details, see Common Request Headers.

Request Elements

This request contains no element.

Response Syntax

HTTP/1.1 status_code
Date: date
Content-Type: type
Content-Length: length

<VersioningConfiguration xmlns="">

Response Headers

This response uses common headers. For details, see Common Response Headers.

Response Elements

This response contains elements to specify the bucket versioning state. Table 1 describes the elements.

Table 1 Response elements



Required or Optional


Indicates the element of versioning state information.

Type: element



Indicates the versioning state of the bucket.

Type: enumeration

Valid values: Enabled, Suspended


Error Responses

No special error responses are returned. For details about error responses, see Table 1.