Skip to content

/AWS1/CL_RDS=>REMOVEFROMGLOBALCLUSTER()

About RemoveFromGlobalCluster

Detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster becomes a standalone cluster with read-write capability instead of being read-only and receiving data from a primary cluster in a different Region.

This operation only applies to Aurora DB clusters.

Method Signature

IMPORTING

Optional arguments:

iv_globalclusteridentifier TYPE /AWS1/RDSSTRING /AWS1/RDSSTRING

The cluster identifier to detach from the Aurora global database cluster.

iv_dbclusteridentifier TYPE /AWS1/RDSSTRING /AWS1/RDSSTRING

The Amazon Resource Name (ARN) identifying the cluster that was detached from the Aurora global database cluster.

RETURNING

oo_output TYPE REF TO /aws1/cl_rdsremfrmglbclustrslt /AWS1/CL_RDSREMFRMGLBCLUSTRSLT

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_rds~removefromglobalcluster(
  iv_dbclusteridentifier = |string|
  iv_globalclusteridentifier = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_globalcluster = lo_result->get_globalcluster( ).
  IF lo_globalcluster IS NOT INITIAL.
    lv_string = lo_globalcluster->get_globalclusteridentifier( ).
    lv_string = lo_globalcluster->get_globalclusterresourceid( ).
    lv_string = lo_globalcluster->get_globalclusterarn( ).
    lv_string = lo_globalcluster->get_status( ).
    lv_string = lo_globalcluster->get_engine( ).
    lv_string = lo_globalcluster->get_engineversion( ).
    lv_string = lo_globalcluster->get_enginelifecyclesupport( ).
    lv_string = lo_globalcluster->get_databasename( ).
    lv_booleanoptional = lo_globalcluster->get_storageencrypted( ).
    lv_booleanoptional = lo_globalcluster->get_deletionprotection( ).
    LOOP AT lo_globalcluster->get_globalclustermembers( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_string = lo_row_1->get_dbclusterarn( ).
        LOOP AT lo_row_1->get_readers( ) into lo_row_2.
          lo_row_3 = lo_row_2.
          IF lo_row_3 IS NOT INITIAL.
            lv_string = lo_row_3->get_value( ).
          ENDIF.
        ENDLOOP.
        lv_boolean = lo_row_1->get_iswriter( ).
        lv_writeforwardingstatus = lo_row_1->get_glbwriteforwardingstatus( ).
        lv_globalclustermembersync = lo_row_1->get_synchronizationstatus( ).
      ENDIF.
    ENDLOOP.
    lv_string = lo_globalcluster->get_endpoint( ).
    lo_failoverstate = lo_globalcluster->get_failoverstate( ).
    IF lo_failoverstate IS NOT INITIAL.
      lv_failoverstatus = lo_failoverstate->get_status( ).
      lv_string = lo_failoverstate->get_fromdbclusterarn( ).
      lv_string = lo_failoverstate->get_todbclusterarn( ).
      lv_boolean = lo_failoverstate->get_isdatalossallowed( ).
    ENDIF.
    LOOP AT lo_globalcluster->get_taglist( ) into lo_row_4.
      lo_row_5 = lo_row_4.
      IF lo_row_5 IS NOT INITIAL.
        lv_string = lo_row_5->get_key( ).
        lv_string = lo_row_5->get_value( ).
      ENDIF.
    ENDLOOP.
  ENDIF.
ENDIF.

To detach an Aurora secondary cluster from an Aurora global database cluster

The following example detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster changes from being read-only to a standalone cluster with read-write capability.

DATA(lo_result) = lo_client->/aws1/if_rds~removefromglobalcluster(
  iv_dbclusteridentifier = |arn:aws:rds:us-west-2:123456789012:cluster:DB-1|
  iv_globalclusteridentifier = |myglobalcluster|
).