Creates or updates the replication configuration for a specific table¶

Description¶

Creates or updates the replication configuration for a specific table. This operation allows you to define table-level replication independently of bucket-level replication, providing granular control over which tables are replicated and where.

Permissions¶

• You must have the s3tables:PutTableReplication permission to use this operation. The IAM role specified in the configuration must have permissions to read from the source table and write to all destination tables.

• You must also have the following permissions:

  • s3tables:GetTable permission on the source table being replicated.
  • s3tables:CreateTable permission for the destination.
  • s3tables:CreateNamespace permission for the destination.
  • s3tables:GetTableMaintenanceConfig permission for the source table.
  • s3tables:PutTableMaintenanceConfig permission for the destination table.

• You must have iam:PassRole permission with condition allowing roles to be passed to replication.s3tables.amazonaws.com.

Usage¶

s3tables_put_table_replication(tableArn, versionToken, configuration)

Arguments¶

• tableArn

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

• versionToken

  A version token from a previous GetTableReplication call. Use this token to ensure you're updating the expected version of the configuration.

• configuration

  [required] The replication configuration to apply to the table, including the IAM role and replication rules.

Value¶

A list with the following syntax:

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

Request syntax¶

svc$put_table_replication(
  tableArn = "string",
  versionToken = "string",
  configuration = list(
    role = "string",
    rules = list(
      list(
        destinations = list(
          list(
            destinationTableBucketARN = "string"
          )
        )
      )
    )
  )
)