/AWS1/IF_DCO=>ALLOCATEHOSTEDCONNECTION()

About AllocateHostedConnection

Creates a hosted connection on the specified interconnect or a link aggregation group (LAG) of interconnects.

Allocates a VLAN number and a specified amount of capacity (bandwidth) for use by a hosted connection on the specified interconnect or LAG of interconnects. Amazon Web Services polices the hosted connection for the specified capacity and the Direct Connect Partner must also police the hosted connection for the specified capacity.

Intended for use by Direct Connect Partners only.

Method Signature

METHODS /AWS1/IF_DCO~ALLOCATEHOSTEDCONNECTION
  IMPORTING
    !IV_CONNECTIONID TYPE /AWS1/DCOCONNECTIONID OPTIONAL
    !IV_OWNERACCOUNT TYPE /AWS1/DCOOWNERACCOUNT OPTIONAL
    !IV_BANDWIDTH TYPE /AWS1/DCOBANDWIDTH OPTIONAL
    !IV_CONNECTIONNAME TYPE /AWS1/DCOCONNECTIONNAME OPTIONAL
    !IV_VLAN TYPE /AWS1/DCOVLAN OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_DCOTAG=>TT_TAGLIST 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_connectionid TYPE /AWS1/DCOCONNECTIONID /AWS1/DCOCONNECTIONID

The ID of the interconnect or LAG.

iv_owneraccount TYPE /AWS1/DCOOWNERACCOUNT /AWS1/DCOOWNERACCOUNT

The ID of the Amazon Web Services account ID of the customer for the connection.

iv_bandwidth TYPE /AWS1/DCOBANDWIDTH /AWS1/DCOBANDWIDTH

The bandwidth of the connection. The possible values are 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps, 10Gbps, and 25Gbps. Note that only those Direct Connect Partners who have met specific requirements are allowed to create a 1Gbps, 2Gbps, 5Gbps, 10Gbps, or 25Gbps hosted connection.

iv_connectionname TYPE /AWS1/DCOCONNECTIONNAME /AWS1/DCOCONNECTIONNAME

The name of the hosted connection.

iv_vlan TYPE /AWS1/DCOVLAN /AWS1/DCOVLAN

The dedicated VLAN provisioned to the hosted connection.

Optional arguments:

it_tags TYPE /AWS1/CL_DCOTAG=>TT_TAGLIST TT_TAGLIST

The tags associated with the connection.

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->allocatehostedconnection(
  it_tags = VALUE /aws1/cl_dcotag=>tt_taglist(
    (
      new /aws1/cl_dcotag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_bandwidth = |string|
  iv_connectionid = |string|
  iv_connectionname = |string|
  iv_owneraccount = |string|
  iv_vlan = 123
).

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.