S3Tables / Client / get_table_replication

get_table_replication¶

S3Tables.Client.get_table_replication(**kwargs)¶

Retrieves the replication configuration for a specific table.

Permissions

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

Request Syntax

response = client.get_table_replication(
    tableArn='string'
)

Parameters:

tableArn (string) –

[REQUIRED]

The Amazon Resource Name (ARN) of the table.

Return type:

dict

Returns:

Response Syntax

{
    'versionToken': 'string',
    'configuration': {
        'role': 'string',
        'rules': [
            {
                'destinations': [
                    {
                        'destinationTableBucketARN': 'string'
                    },
                ]
            },
        ]
    }
}

Response Structure

(dict) –
- versionToken (string) –
  
  A version token that represents the current state of the table’s replication configuration. Use this token when updating the configuration to ensure consistency.
- configuration (dict) –
  
  The replication configuration for the table, including the IAM role and replication rules.
  - role (string) –
    
    The Amazon Resource Name (ARN) of the IAM role that S3 Tables assumes to replicate the table on your behalf.
  - rules (list) –
    
    An array of replication rules that define where this table should be replicated.
    - (dict) –
      
      Defines a rule for replicating a table to one or more destination tables.
      - destinations (list) –
        
        An array of destination table buckets where this table should be replicated.
        
        (dict) –
        
        Specifies a destination table bucket for replication.
        
        destinationTableBucketARN (string) –
        
        The Amazon Resource Name (ARN) of the destination table bucket where tables will be replicated.

Exceptions

S3Tables.Client.exceptions.InternalServerErrorException
S3Tables.Client.exceptions.ForbiddenException
S3Tables.Client.exceptions.NotFoundException
S3Tables.Client.exceptions.AccessDeniedException
S3Tables.Client.exceptions.TooManyRequestsException
S3Tables.Client.exceptions.ConflictException
S3Tables.Client.exceptions.BadRequestException