getBucketLogging method
Written by
Updated at September 30, 2024
Returns the settings for bucket actions logging.
For more information on getting started with the API and the general request format, see How to use the S3 API.
Request
GET /{bucket}?logging HTTP/2
Path parameters
Parameter | Description |
---|---|
bucket |
Bucket name. |
Query parameters
Parameter | Description |
---|---|
logging |
Required parameter that indicates the type of operation. |
Headers
Use common request headers in your requests.
Response
Headers
Responses can only contain common response 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
Response if logging of actions with the bucket is not configured:
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<!--<LoggingEnabled><TargetBucket>bucket-logs</TargetBucket><TargetPrefix>add/this/prefix/to/my/log/files/access_log-</TargetPrefix></LoggingEnabled>-->
</BucketLoggingStatus>
Response if logging of actions with the bucket is configured:
<?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 |
Name of the target bucket where objects with logs are saved. Path: /BucketLoggingStatus/LoggingEnabled/TargetBucket .Type: String. |
TargetPrefix |
Log object key prefix. Path: /BucketLoggingStatus/LoggingEnabled/TargetPrefix .Type: String. |