getBucketVersioning method
Written by
Updated at September 2, 2025
Returns the bucket versioning status.
For more information on getting started with the API and the general request format, see How to use the S3 API.
Request
GET /{bucket}?versioning HTTP/2
Path parameters
| Parameter | Description |
|---|---|
bucket |
Bucket name. |
Request parameters
| Parameter | Description |
|---|---|
versioning |
Required parameter that indicates the type of operation. |
Headers
Use common headers in your requests.
Response
Headers
Responses can only contain common headers.
Response codes
For a list of possible responses, see Responses.
A successful response contains additional data in XML format with the schema described below.
Data schema
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult
xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<KeyCount>1</KeyCount>
<Name>my-sample-bucket</Name>
<Prefix></Prefix>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>text.txt</Key>
<LastModified>2025-05-15T07:23:08.030Z</LastModified>
<Owner>
<ID>ajegtlf2q28a********</ID>
<DisplayName>ajegtlf2q28a********</DisplayName>
</Owner>
<ETag>"f75a361db63aa4722fb8e083********"</ETag>
<Size>103</Size>
<StorageClass>STANDARD</StorageClass>
<TagSet></TagSet>
</Contents>
</ListBucketResult>
| Element | Description |
|---|---|
VersioningConfiguration |
Root element. |
Status |
Bucket versioning status. Path: /VersioningConfiguration/Status.Type: String. The possible values are: `Enabled |