Skip to content

/AWS1/CL_ECA=>CREATEGLOBALREPLICATIONGROUP()

About CreateGlobalReplicationGroup

Global Datastore offers fully managed, fast, reliable and secure cross-region replication. Using Global Datastore with Valkey or Redis OSS, you can create cross-region read replica clusters for ElastiCache to enable low-latency reads and disaster recovery across regions. For more information, see Replication Across Regions Using Global Datastore.

  • The GlobalReplicationGroupIdSuffix is the name of the Global datastore.

  • The PrimaryReplicationGroupId represents the name of the primary cluster that accepts writes and will replicate updates to the secondary cluster.

Method Signature

IMPORTING

Required arguments:

iv_globalreplgroupidsuffix TYPE /AWS1/ECASTRING /AWS1/ECASTRING

The suffix name of a Global datastore. Amazon ElastiCache automatically applies a prefix to the Global datastore ID when it is created. Each Amazon Region has its own prefix. For instance, a Global datastore ID created in the US-West-1 region will begin with "dsdfu" along with the suffix name you provide. The suffix, combined with the auto-generated prefix, guarantees uniqueness of the Global datastore name across multiple regions.

For a full list of Amazon Regions and their respective Global datastore iD prefixes, see Using the Amazon CLI with Global datastores .

iv_primaryreplicationgroupid TYPE /AWS1/ECASTRING /AWS1/ECASTRING

The name of the primary cluster that accepts writes and will replicate updates to the secondary cluster.

Optional arguments:

iv_globalreplgroupdesc TYPE /AWS1/ECASTRING /AWS1/ECASTRING

Provides details of the Global datastore

RETURNING

oo_output TYPE REF TO /aws1/cl_ecacreglbreplgrprslt /AWS1/CL_ECACREGLBREPLGRPRSLT

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_eca~createglobalreplicationgroup(
  iv_globalreplgroupdesc = |string|
  iv_globalreplgroupidsuffix = |string|
  iv_primaryreplicationgroupid = |string|
).

This is an example of reading all possible response values

lv_string = lo_globalreplicationgroup->get_globalreplicationgroupid( ).
lv_string = lo_globalreplicationgroup->get_globalreplgroupdesc( ).
lv_string = lo_globalreplicationgroup->get_status( ).
lv_string = lo_globalreplicationgroup->get_cachenodetype( ).
lv_string = lo_globalreplicationgroup->get_engine( ).
lv_string = lo_globalreplicationgroup->get_engineversion( ).
LOOP AT lo_globalreplicationgroup->get_members( ) into lo_row.
  lv_string = lo_row_1->get_replicationgroupid( ).
  lv_string = lo_row_1->get_replicationgroupregion( ).
  lv_string = lo_row_1->get_role( ).
  lv_automaticfailoverstatus = lo_row_1->get_automaticfailover( ).
  lv_string = lo_row_1->get_status( ).
ENDLOOP.
lv_booleanoptional = lo_globalreplicationgroup->get_clusterenabled( ).
LOOP AT lo_globalreplicationgroup->get_globalnodegroups( ) into lo_row_2.
  lv_string = lo_row_3->get_globalnodegroupid( ).
  lv_string = lo_row_3->get_slots( ).
ENDLOOP.
lv_booleanoptional = lo_globalreplicationgroup->get_authtokenenabled( ).
lv_booleanoptional = lo_globalreplicationgroup->get_transitencryptionenabled( ).
lv_booleanoptional = lo_globalreplicationgroup->get_atrestencryptionenabled( ).
lv_string = lo_globalreplicationgroup->get_arn( ).