Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI Studio
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Object Storage
  • Pricing policy
  • Terraform reference
    • API authentication
      • How to use the API
      • Signing requests
      • Getting started with the S3 API
        • All services and methods
          • All methods
          • create
          • getBucketEncryption
          • getMeta
          • listObjects
          • listBuckets
          • deleteBucket
          • deleteBucketEncryption
          • putBucketEncryption
          • putBucketVersioning
          • getBucketVersioning
          • putBucketLogging
          • getBucketLogging
          • listObjectVersions
          • putObjectLockConfiguration
          • getObjectLockConfiguration
          • putBucketTagging
          • getBucketTagging
          • deleteBucketTagging
        • Common request headers
        • Common response headers
        • Responses
  • Monitoring metrics
  • Audit Trails events
  • Bucket logs
  • Release notes
  • FAQ

In this article:

  • Request
  • Path parameters
  • Request parameters
  • Headers
  • Response
  • Headers
  • Response codes
  • Data schema
  1. API reference
  2. REST (Amazon S3-compatible)
  3. REST
  4. Bucket
  5. getBucketLogging

getBucketLogging method

Written by
Yandex Cloud
Updated at June 11, 2025
  • Request
    • Path parameters
    • Request parameters
    • Headers
  • Response
    • Headers
    • Response codes
    • Data schema

Returns the settings for bucket logging.

For more information on getting started with the API and the general request format, see How to use the S3 API.

RequestRequest

GET /{bucket}?logging HTTP/2

Path parametersPath parameters

Parameter Description
bucket Bucket name.

Request parametersRequest parameters

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

HeadersHeaders

Use common headers in your requests.

ResponseResponse

HeadersHeaders

Responses can only contain common headers.

Response codesResponse codes

For a list of possible responses, see Responses.

A successful response contains additional data in XML format with the schema described below.

Data schemaData schema

Response if bucket logging 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 bucket logging 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.

See alsoSee also

  • Getting started with the AWS S3 API in Yandex Object Storage
  • Debugging requests using the AWS CLI
  • Example of sending a signed request using curl
  • Code example for generating a signature

Was the article helpful?

Previous
putBucketLogging
Next
listObjectVersions
© 2025 Direct Cursus Technology L.L.C.