PutBucketLogging

Enables and disables the mechanism for logging actions with the bucket.

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	The name of the target bucket where the objects are saved with logs. Type: String.
TargetPrefix	Object key prefix with logs. Type: String.

To disable logging of actions with the bucket:

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

Headers

Use only common request headers in requests.

Response

Headers

Responses can only contain common response headers.

Response codes

For a list of possible responses, see Responses.

A successful response does not contain any additional data.