Creates or updates the replication configuration for a table bucket¶
Description¶
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:PutTableBucketReplicationpermission 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:GetTablepermission on the source table.s3tables:ListTablespermission on the bucket containing the table.s3tables:CreateTablepermission for the destination.s3tables:CreateNamespacepermission for the destination.s3tables:GetTableMaintenanceConfigpermission for the source bucket.s3tables:PutTableMaintenanceConfigpermission for the destination bucket.
-
You must have
iam:PassRolepermission with condition allowing roles to be passed toreplication.s3tables.amazonaws.com.
Usage¶
Arguments¶
-
tableBucketARN[required] The Amazon Resource Name (ARN) of the source table bucket.
-
versionTokenA version token from a previous GetTableBucketReplication call. Use this token to ensure you're updating the expected version of the configuration.
-
configuration[required] The replication configuration to apply, including the IAM role and replication rules.
Value¶
A list with the following syntax: