Skip to content

/AWS1/IF_GAC=>UPDATEACCELERATOR()

About UpdateAccelerator

Update an accelerator to make changes, such as the following:

  • Change the name of the accelerator.

  • Disable the accelerator so that it no longer accepts or routes traffic, or so that you can delete it.

  • Enable the accelerator, if it is disabled.

  • Change the IP address type to dual-stack if it is IPv4, or change the IP address type to IPv4 if it's dual-stack.

Be aware that static IP addresses remain assigned to your accelerator for as long as it exists, even if you disable the accelerator and it no longer accepts or routes traffic. However, when you delete the accelerator, you lose the static IP addresses that are assigned to it, so you can no longer route traffic by using them.

Global Accelerator is a global service that supports endpoints in multiple Amazon Web Services Regions but you must specify the US West (Oregon) Region to create, update, or otherwise work with accelerators. That is, for example, specify --region us-west-2 on Amazon Web Services CLI commands.

Method Signature

IMPORTING

Required arguments:

iv_acceleratorarn TYPE /AWS1/GACGENERICSTRING /AWS1/GACGENERICSTRING

The Amazon Resource Name (ARN) of the accelerator to update.

Optional arguments:

iv_name TYPE /AWS1/GACGENERICSTRING /AWS1/GACGENERICSTRING

The name of the accelerator. The name can have a maximum of 64 characters, must contain only alphanumeric characters, periods (.), or hyphens (-), and must not begin or end with a hyphen or period.

iv_ipaddresstype TYPE /AWS1/GACIPADDRESSTYPE /AWS1/GACIPADDRESSTYPE

The IP address type that an accelerator supports. For a standard accelerator, the value can be IPV4 or DUAL_STACK.

it_ipaddresses TYPE /AWS1/CL_GACIPADDRESSES_W=>TT_IPADDRESSES TT_IPADDRESSES

The IP addresses for an accelerator.

iv_enabled TYPE /AWS1/GACGENERICBOOLEAN /AWS1/GACGENERICBOOLEAN

Indicates whether an accelerator is enabled. The value is true or false. The default value is true.

If the value is set to true, the accelerator cannot be deleted. If set to false, the accelerator can be deleted.

RETURNING

oo_output TYPE REF TO /aws1/cl_gacupdacceleratorrsp /AWS1/CL_GACUPDACCELERATORRSP

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_gac~updateaccelerator(
  it_ipaddresses = VALUE /aws1/cl_gacipaddresses_w=>tt_ipaddresses(
    ( new /aws1/cl_gacipaddresses_w( |string| ) )
  )
  iv_acceleratorarn = |string|
  iv_enabled = ABAP_TRUE
  iv_ipaddresstype = |string|
  iv_name = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_accelerator = lo_result->get_accelerator( ).
  IF lo_accelerator IS NOT INITIAL.
    lv_genericstring = lo_accelerator->get_acceleratorarn( ).
    lv_genericstring = lo_accelerator->get_name( ).
    lv_ipaddresstype = lo_accelerator->get_ipaddresstype( ).
    lv_genericboolean = lo_accelerator->get_enabled( ).
    LOOP AT lo_accelerator->get_ipsets( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_genericstring = lo_row_1->get_ipfamily( ).
        LOOP AT lo_row_1->get_ipaddresses( ) into lo_row_2.
          lo_row_3 = lo_row_2.
          IF lo_row_3 IS NOT INITIAL.
            lv_ipaddress = lo_row_3->get_value( ).
          ENDIF.
        ENDLOOP.
        lv_ipaddressfamily = lo_row_1->get_ipaddressfamily( ).
      ENDIF.
    ENDLOOP.
    lv_genericstring = lo_accelerator->get_dnsname( ).
    lv_acceleratorstatus = lo_accelerator->get_status( ).
    lv_timestamp = lo_accelerator->get_createdtime( ).
    lv_timestamp = lo_accelerator->get_lastmodifiedtime( ).
    lv_genericstring = lo_accelerator->get_dualstackdnsname( ).
    LOOP AT lo_accelerator->get_events( ) into lo_row_4.
      lo_row_5 = lo_row_4.
      IF lo_row_5 IS NOT INITIAL.
        lv_genericstring = lo_row_5->get_message( ).
        lv_timestamp = lo_row_5->get_timestamp( ).
      ENDIF.
    ENDLOOP.
  ENDIF.
ENDIF.