/AWS1/CL_XDD=>CREATEMULTIREGIONCLUSTERS()

About CreateMultiRegionClusters

Creates multi-Region clusters in Amazon Aurora DSQL. Multi-Region clusters require a linked Region list, which is an array of the Regions in which you want to create linked clusters. Multi-Region clusters require a witness Region, which participates in quorum in failure scenarios.

Method Signature

IMPORTING

Required arguments:

it_linkedregionlist TYPE /AWS1/CL_XDDREGIONLIST_W=>TT_REGIONLIST TT_REGIONLIST

An array of the Regions in which you want to create additional clusters.

iv_witnessregion TYPE /AWS1/XDDREGION /AWS1/XDDREGION

The witness Region of multi-Region clusters.

Optional arguments:

it_clusterproperties TYPE /AWS1/CL_XDDLINKEDCLUSTERPRPS=>TT_CLUSTERPROPERTYMAP TT_CLUSTERPROPERTYMAP

A mapping of properties to use when creating linked clusters.

iv_clienttoken TYPE /AWS1/XDDCLIENTTOKEN /AWS1/XDDCLIENTTOKEN

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully. The subsequent retries with the same client token return the result from the original successful request and they have no additional effect.

If you don't specify a client token, the Amazon Web Services SDK automatically generates one.

RETURNING

oo_output TYPE REF TO /aws1/cl_xddcremultiregioncl01 /AWS1/CL_XDDCREMULTIREGIONCL01

Domain	/AWS1/RT_ACCOUNT_ID
Primitive Type	NUMC

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->/aws1/if_xdd~createmultiregionclusters(
  it_clusterproperties = VALUE /aws1/cl_xddlinkedclusterprps=>tt_clusterpropertymap(
    (
      VALUE /aws1/cl_xddlinkedclusterprps=>ts_clusterpropertymap_maprow(
        value = new /aws1/cl_xddlinkedclusterprps(
          it_tags = VALUE /aws1/cl_xddtagmap_w=>tt_tagmap(
            (
              VALUE /aws1/cl_xddtagmap_w=>ts_tagmap_maprow(
                key = |string|
                value = new /aws1/cl_xddtagmap_w( |string| )
              )
            )
          )
          iv_deletionprotectionenabled = ABAP_TRUE
        )
        key = |string|
      )
    )
  )
  it_linkedregionlist = VALUE /aws1/cl_xddregionlist_w=>tt_regionlist(
    ( new /aws1/cl_xddregionlist_w( |string| ) )
  )
  iv_clienttoken = |string|
  iv_witnessregion = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_linkedclusterarns( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_clusterarn = lo_row_1->get_value( ).
    ENDIF.
  ENDLOOP.
ENDIF.

Create Multi Region Clusters

Create Multi Region Clusters

DATA(lo_result) = lo_client->/aws1/if_xdd~createmultiregionclusters(
  it_linkedregionlist = VALUE /aws1/cl_xddregionlist_w=>tt_regionlist(
    ( new /aws1/cl_xddregionlist_w( |us-east-1| ) )
    ( new /aws1/cl_xddregionlist_w( |us-east-2| ) )
  )
  iv_witnessregion = |us-west-2|
).