Skip to content

Put Table Bucket Replication

s3tables_put_table_bucket_replication R Documentation

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: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.

Usage

s3tables_put_table_bucket_replication(tableBucketARN, versionToken,
  configuration)

Arguments

tableBucketARN

[required] The Amazon Resource Name (ARN) of the source table bucket.
versionToken

A 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:

list(
  versionToken = "string",
  status = "string"
)

Request syntax

svc$put_table_bucket_replication(
  tableBucketARN = "string",
  versionToken = "string",
  configuration = list(
    role = "string",
    rules = list(
      list(
        destinations = list(
          list(
            destinationTableBucketARN = "string"
          )
        )
      )
    )
  )
)