# PutBucketVersioning

Enables or pauses versioning of the bucket.

Versioning can be set to one of two statuses:

* `Enabled`: Turn on version management for objects in the bucket. All new objects added to the bucket get a unique version ID.
* `Suspended`: Suspends version management for objects in the bucket. All new objects added to the bucket get `null` as the version ID.

### Request

```
PUT /{bucket}?versioning HTTP/1.1
```

#### Path parameters

| Parameter | Description  |
| --------- | ------------ |
| `bucket`  | Bucket name. |

#### Query parameters

| Parameter    | Description                                              |
| ------------ | -------------------------------------------------------- |
| `versioning` | Required parameter that indicates the type of operation. |

#### Data schema

```
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
   <Status>string</Status>
</VersioningConfiguration>
```

| Element  | Description                                                                                      |                      |
| -------- | ------------------------------------------------------------------------------------------------ | -------------------- |
| `Status` | <p>Status of the bucket versioning option.<br><br>Type: String<br>Possible values: <code>Enabled | Suspended</code></p> |

#### Headers

Use only [common request headers](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/common-request-headers) in requests.

### Response

#### Headers

Responses can only contain [common response headers](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/common-response-headers).

#### Response codes

For a list of possible responses, see [Responses](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/answers).

A successful response does not contain any additional data.

<br>