---
title: "PUT /table-bucket-replication#tableBucketARN"
method: PUT
path: "/table-bucket-replication#tableBucketARN"
---

# PUT /table-bucket-replication#tableBucketARN

`PUT /table-bucket-replication#tableBucketARN`

Creates or updates the replication configuration for a table bucket. This operation defines how tables in the source bucket are replicated to destination buckets. Replication helps ensure data availability and disaster recovery across regions or accounts.

Permissions

*   You must have the `s3tables:PutTableBucketReplication` permission to use this operation. The IAM role specified in the configuration must have permissions to read from the source bucket and write permissions to all destination buckets.
    
*   You must also have the following permissions:
    
    *   `s3tables:GetTable` permission on the source table.
        
    *   `s3tables:ListTables` permission on the bucket containing the table.
        
    *   `s3tables:CreateTable` permission for the destination.
        
    *   `s3tables:CreateNamespace` permission for the destination.
        
    *   `s3tables:GetTableMaintenanceConfig` permission for the source bucket.
        
    *   `s3tables:PutTableMaintenanceConfig` permission for the destination bucket.
        
*   You must have `iam:PassRole` permission with condition allowing roles to be passed to `replication.s3tables.amazonaws.com`.

## Query parameters

- `tableBucketARN` string, required
- `versionToken` string

## Request body

- object
  - `configuration` object, required — The replication configuration for a table bucket. This configuration defines how tables in the source bucket are replicated to destination table buckets, including the IAM role used for replication.
    - `role` string — The Amazon Resource Name (ARN) of the IAM role that S3 Tables assumes to replicate tables on your behalf.
    - `rules` TableBucketReplicationRule[] — An array of replication rules that define which tables to replicate and where to replicate them.
      - `destinations` ReplicationDestination[], required — An array of destination table buckets where tables should be replicated.
        - `destinationTableBucketARN` string, required — The Amazon Resource Name (ARN) of the destination table bucket where tables will be replicated.

## Response `200`

Success

- PutTableBucketReplicationResponse
  - `versionToken` string, required — A new version token representing the updated replication configuration.
  - `status` string, required — The status of the replication configuration operation.

## Other responses

- `480` — InternalServerErrorException
- `481` — ForbiddenException
- `482` — NotFoundException
- `483` — AccessDeniedException
- `484` — TooManyRequestsException
- `485` — ConflictException
- `486` — BadRequestException

---

[API](https://skmtc.net/aws/apis/s3tables.md) · [All operations](https://skmtc.net/aws/apis/s3tables/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/s3tables/versions/d7413f19d46e/schema)