# PutBucketLogging

Enables and disables the [mechanism for logging actions with the bucket](https://cloud.yandex.com/docs/storage/concepts/server-logs).

### Request

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

#### Path parameters

| Parameter | Description         |
| --------- | ------------------- |
| `bucket`  | Name of the bucket. |

#### Query parameters

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

#### Data schema

**To enable logging of actions with the bucket:**

```
<?xml version="1.0" encoding="UTF-8" ?>
<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <LoggingEnabled>
      <TargetBucket>bucket-logs</TargetBucket>
      <TargetPrefix>logs/</TargetPrefix>
   </LoggingEnabled>
</BucketLoggingStatus>
```

| Element               | Description                                                                                  |
| --------------------- | -------------------------------------------------------------------------------------------- |
| `BucketLoggingStatus` | Root element.                                                                                |
| `TargetBucket`        | <p>The name of the target bucket where the objects are saved with logs.<br>Type: String.</p> |
| `TargetPrefix`        | <p>Object key prefix with logs.<br>Type: String.</p>                                         |

**To disable logging of actions with the bucket:**

```
<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01" />
```

#### 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://cloud.yandex.com/docs/storage/s3/api-ref/response-codes).

A successful response does not contain any additional data.

<br>