ASSOCIATECUSTOMERGATEWAY()`¶

About AssociateCustomerGateway¶

Associates a customer gateway with a device and optionally, with a link. If you specify a link, it must be associated with the specified device.

You can only associate customer gateways that are connected to a VPN attachment on a transit gateway or core network registered in your global network. When you register a transit gateway or core network, customer gateways that are connected to the transit gateway are automatically included in the global network. To list customer gateways that are connected to a transit gateway, use the DescribeVpnConnections EC2 API and filter by transit-gateway-id.

You cannot associate a customer gateway with more than one device and link.

Method Signature¶

METHODS /AWS1/IF_NWM~ASSOCIATECUSTOMERGATEWAY
  IMPORTING
    !IV_CUSTOMERGATEWAYARN TYPE /AWS1/NWMCUSTOMERGATEWAYARN OPTIONAL
    !IV_GLOBALNETWORKID TYPE /AWS1/NWMGLOBALNETWORKID OPTIONAL
    !IV_DEVICEID TYPE /AWS1/NWMDEVICEID OPTIONAL
    !IV_LINKID TYPE /AWS1/NWMLINKID OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_nwmassoccusgatewayrsp
  RAISING
    /AWS1/CX_NWMACCESSDENIEDEX
    /AWS1/CX_NWMCONFLICTEXCEPTION
    /AWS1/CX_NWMINTERNALSERVEREX
    /AWS1/CX_NWMRESOURCENOTFOUNDEX
    /AWS1/CX_NWMSERVICEQUOTAEXCDEX
    /AWS1/CX_NWMTHROTTLINGEX
    /AWS1/CX_NWMVALIDATIONEX
    /AWS1/CX_NWMCLIENTEXC
    /AWS1/CX_NWMSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_customergatewayarn` `TYPE /AWS1/NWMCUSTOMERGATEWAYARN` `/AWS1/NWMCUSTOMERGATEWAYARN`¶

The Amazon Resource Name (ARN) of the customer gateway.

`iv_globalnetworkid` `TYPE /AWS1/NWMGLOBALNETWORKID` `/AWS1/NWMGLOBALNETWORKID`¶

The ID of the global network.

`iv_deviceid` `TYPE /AWS1/NWMDEVICEID` `/AWS1/NWMDEVICEID`¶

The ID of the device.

Optional arguments:¶

`iv_linkid` `TYPE /AWS1/NWMLINKID` `/AWS1/NWMLINKID`¶

The ID of the link.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_nwmassoccusgatewayrsp` `/AWS1/CL_NWMASSOCCUSGATEWAYRSP`¶

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->associatecustomergateway(
  iv_customergatewayarn = |string|
  iv_deviceid = |string|
  iv_globalnetworkid = |string|
  iv_linkid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_customergatewayassociat = lo_result->get_cusgatewayassociation( ).
  IF lo_customergatewayassociat IS NOT INITIAL.
    lv_customergatewayarn = lo_customergatewayassociat->get_customergatewayarn( ).
    lv_globalnetworkid = lo_customergatewayassociat->get_globalnetworkid( ).
    lv_deviceid = lo_customergatewayassociat->get_deviceid( ).
    lv_linkid = lo_customergatewayassociat->get_linkid( ).
    lv_customergatewayassociat_1 = lo_customergatewayassociat->get_state( ).
  ENDIF.
ENDIF.

/AWS1/IF_NWM=>ASSOCIATECUSTOMERGATEWAY()¶