/AWS1/IF_DCO=>CREATECONNECTION()

About CreateConnection

Creates a connection between a customer network and a specific Direct Connect location.

A connection links your internal network to an Direct Connect location over a standard Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an Direct Connect router.

To find the locations for your Region, use DescribeLocations.

You can automatically add the new connection to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new connection is allocated on the same Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no connection is created.

Method Signature

METHODS /AWS1/IF_DCO~CREATECONNECTION
  IMPORTING
    !IV_LOCATION TYPE /AWS1/DCOLOCATIONCODE OPTIONAL
    !IV_BANDWIDTH TYPE /AWS1/DCOBANDWIDTH OPTIONAL
    !IV_CONNECTIONNAME TYPE /AWS1/DCOCONNECTIONNAME OPTIONAL
    !IV_LAGID TYPE /AWS1/DCOLAGID OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_DCOTAG=>TT_TAGLIST OPTIONAL
    !IV_PROVIDERNAME TYPE /AWS1/DCOPROVIDERNAME OPTIONAL
    !IV_REQUESTMACSEC TYPE /AWS1/DCOREQUESTMACSEC OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_dcoconnection
  RAISING
    /AWS1/CX_DCODIRECTCNCTCLIENTEX
    /AWS1/CX_DCODIRECTCNCTSERVEREX
    /AWS1/CX_DCODUPLICATETAGKEYSEX
    /AWS1/CX_DCOTOOMANYTAGSEX
    /AWS1/CX_DCOCLIENTEXC
    /AWS1/CX_DCOSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_location TYPE /AWS1/DCOLOCATIONCODE /AWS1/DCOLOCATIONCODE

The location of the connection.

iv_bandwidth TYPE /AWS1/DCOBANDWIDTH /AWS1/DCOBANDWIDTH

The bandwidth of the connection.

iv_connectionname TYPE /AWS1/DCOCONNECTIONNAME /AWS1/DCOCONNECTIONNAME

The name of the connection.

Optional arguments:

iv_lagid TYPE /AWS1/DCOLAGID /AWS1/DCOLAGID

The ID of the LAG.

it_tags TYPE /AWS1/CL_DCOTAG=>TT_TAGLIST TT_TAGLIST

The tags to associate with the lag.

iv_providername TYPE /AWS1/DCOPROVIDERNAME /AWS1/DCOPROVIDERNAME

The name of the service provider associated with the requested connection.

iv_requestmacsec TYPE /AWS1/DCOREQUESTMACSEC /AWS1/DCOREQUESTMACSEC

Indicates whether you want the connection to support MAC Security (MACsec).

MAC Security (MACsec) is unavailable on hosted connections. For information about MAC Security (MACsec) prerequisites, see MAC Security in Direct Connect in the Direct Connect User Guide.

RETURNING

oo_output TYPE REF TO /aws1/cl_dcoconnection /AWS1/CL_DCOCONNECTION

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->createconnection(
  it_tags = VALUE /aws1/cl_dcotag=>tt_taglist(
    (
      new /aws1/cl_dcotag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_bandwidth = |string|
  iv_connectionname = |string|
  iv_lagid = |string|
  iv_location = |string|
  iv_providername = |string|
  iv_requestmacsec = ABAP_TRUE
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_owneraccount = lo_result->get_owneraccount( ).
  lv_connectionid = lo_result->get_connectionid( ).
  lv_connectionname = lo_result->get_connectionname( ).
  lv_connectionstate = lo_result->get_connectionstate( ).
  lv_region = lo_result->get_region( ).
  lv_locationcode = lo_result->get_location( ).
  lv_bandwidth = lo_result->get_bandwidth( ).
  lv_vlan = lo_result->get_vlan( ).
  lv_partnername = lo_result->get_partnername( ).
  lv_loaissuetime = lo_result->get_loaissuetime( ).
  lv_lagid = lo_result->get_lagid( ).
  lv_awsdevice = lo_result->get_awsdevice( ).
  lv_jumboframecapable = lo_result->get_jumboframecapable( ).
  lv_awsdevicev2 = lo_result->get_awsdevicev2( ).
  lv_awslogicaldeviceid = lo_result->get_awslogicaldeviceid( ).
  lv_haslogicalredundancy = lo_result->get_haslogicalredundancy( ).
  LOOP AT lo_result->get_tags( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_tagkey = lo_row_1->get_key( ).
      lv_tagvalue = lo_row_1->get_value( ).
    ENDIF.
  ENDLOOP.
  lv_providername = lo_result->get_providername( ).
  lv_macseccapable = lo_result->get_macseccapable( ).
  lv_portencryptionstatus = lo_result->get_portencryptionstatus( ).
  lv_encryptionmode = lo_result->get_encryptionmode( ).
  LOOP AT lo_result->get_macseckeys( ) into lo_row_2.
    lo_row_3 = lo_row_2.
    IF lo_row_3 IS NOT INITIAL.
      lv_secretarn = lo_row_3->get_secretarn( ).
      lv_ckn = lo_row_3->get_ckn( ).
      lv_state = lo_row_3->get_state( ).
      lv_startondate = lo_row_3->get_starton( ).
    ENDIF.
  ENDLOOP.
  lv_partnerinterconnectmacs = lo_result->get_ptrintercnctmacseccapa00( ).
ENDIF.