Skip to content

/AWS1/IF_S3T=>PUTTABLEREPLICATION()

About PutTableReplication

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.

Method Signature

METHODS /AWS1/IF_S3T~PUTTABLEREPLICATION
  IMPORTING
    !IV_TABLEARN TYPE /AWS1/S3TTABLEARN OPTIONAL
    !IV_VERSIONTOKEN TYPE /AWS1/S3TSTRING OPTIONAL
    !IO_CONFIGURATION TYPE REF TO /AWS1/CL_S3TTABLEREPLCONF OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_s3tputtablereplrsp
  RAISING
    /AWS1/CX_S3TACCESSDENIEDEX
    /AWS1/CX_S3TBADREQUESTEX
    /AWS1/CX_S3TCONFLICTEXCEPTION
    /AWS1/CX_S3TFORBIDDENEXCEPTION
    /AWS1/CX_S3TINTERNALSERVERER00
    /AWS1/CX_S3TNOTFOUNDEXCEPTION
    /AWS1/CX_S3TTOOMANYREQUESTSEX
    /AWS1/CX_S3TCLIENTEXC
    /AWS1/CX_S3TSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_tablearn TYPE /AWS1/S3TTABLEARN /AWS1/S3TTABLEARN

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

io_configuration TYPE REF TO /AWS1/CL_S3TTABLEREPLCONF /AWS1/CL_S3TTABLEREPLCONF

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

Optional arguments:

iv_versiontoken TYPE /AWS1/S3TSTRING /AWS1/S3TSTRING

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

RETURNING

oo_output TYPE REF TO /aws1/cl_s3tputtablereplrsp /AWS1/CL_S3TPUTTABLEREPLRSP

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->puttablereplication(
  io_configuration = new /aws1/cl_s3ttablereplconf(
    it_rules = VALUE /aws1/cl_s3ttablereplrule=>tt_tablereplicationrules(
      (
        new /aws1/cl_s3ttablereplrule(
          it_destinations = VALUE /aws1/cl_s3treplicationdst=>tt_replicationdestinations(
            ( new /aws1/cl_s3treplicationdst( |string| ) )
          )
        )
      )
    )
    iv_role = |string|
  )
  iv_tablearn = |string|
  iv_versiontoken = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_string = lo_result->get_versiontoken( ).
  lv_string = lo_result->get_status( ).
ENDIF.