Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors Examples See Also

PutTableBucketLogging

Sets, updates, or removes the server access logging configuration for a table bucket. When logging is enabled, Amazon S3 delivers a record of the requests made to the table bucket and its tables to the target general purpose bucket that you specify. To disable logging, call this operation with an empty tableBucketLoggingStatus. For more information, see Server access logging for table buckets in the Amazon Simple Storage Service User Guide.

Permissions: You must have the s3tables:PutTableBucketLogging permission to use this operation.

Request Syntax


PUT /buckets/tableBucketARN/logging HTTP/1.1
Content-type: application/json

{
   "tableBucketLoggingStatus": { 
      "loggingEnabled": { 
         "targetBucket": "string",
         "targetObjectKeyFormat": { 
            "partitionedPrefix": { 
               "partitionDateSource": "string"
            }
         },
         "targetPrefix": "string"
      }
   }
}

URI Request Parameters

The request uses the following URI parameters.

tableBucketARN

The Amazon Resource Name (ARN) of the table bucket.

Pattern: (arn:aws[-a-z0-9]*:[a-z0-9]+:[-a-z0-9]*:[0-9]{12}:bucket/[a-z0-9_-]{3,63})

Required: Yes

Request Body

The request accepts the following data in JSON format.

tableBucketLoggingStatus

The logging status to apply to the table bucket. To disable logging, specify an empty tableBucketLoggingStatus.

Type: TableBucketLoggingStatus object

Required: Yes

Response Syntax


HTTP/1.1 204

Response Elements

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

Errors

BadRequestException

The request is invalid or malformed.

HTTP Status Code: 400

ConflictException

The request failed because there is a conflict with a previous write. You can retry the request.

HTTP Status Code: 409

ForbiddenException

The caller isn't authorized to make the request.

HTTP Status Code: 403

InternalServerErrorException

The request failed due to an internal server error.

HTTP Status Code: 500

NotFoundException

The request was rejected because the specified resource could not be found.

HTTP Status Code: 404

TooManyRequestsException

The limit on the number of requests per second was exceeded.

HTTP Status Code: 429

Examples

Sample Request: Enabling logging

This request enables server access logging for the table bucket arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket. Logs are delivered to the general purpose bucket amzn-s3-demo-destination-bucket under the prefix logs/, with object keys partitioned by the time of the logged events.



PUT /buckets/<URL-encoded table bucket ARN>/logging HTTP/1.1
Host: s3tables.us-east-1.amazonaws.com
Date: Wed, 04 Nov 2026 12:00:00 GMT
Authorization: authorization string
Content-Type: application/json

{
  "tableBucketLoggingStatus": {
    "loggingEnabled": {
      "targetBucket": "amzn-s3-demo-destination-bucket",
      "targetPrefix": "logs/",
      "targetObjectKeyFormat": {
        "partitionedPrefix": {
          "partitionDateSource": "EventTime"
        }
      }
    }
  }
}

Sample Response

This example illustrates one usage of PutTableBucketLogging.



HTTP/1.1 204 No Content

Sample Request: Disabling logging

This request disables server access logging for the table bucket arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket.



PUT /buckets/<URL-encoded table bucket ARN>/logging HTTP/1.1
Host: s3tables.us-east-1.amazonaws.com
Date: Wed, 04 Nov 2026 12:00:00 GMT
Authorization: authorization string
Content-Type: application/json

{
  "tableBucketLoggingStatus": {}
}

Sample Response

This example illustrates one usage of PutTableBucketLogging.



HTTP/1.1 204 No Content