Skip to content

/AWS1/IF_NWM=>CREATELINK()

Creates a new link for a specified site.

Method Signature

METHODS /AWS1/IF_NWM~CREATELINK
  IMPORTING
    !IV_GLOBALNETWORKID TYPE /AWS1/NWMGLOBALNETWORKID OPTIONAL
    !IV_DESCRIPTION TYPE /AWS1/NWMCONSTRAINEDSTRING OPTIONAL
    !IV_TYPE TYPE /AWS1/NWMCONSTRAINEDSTRING OPTIONAL
    !IO_BANDWIDTH TYPE REF TO /AWS1/CL_NWMBANDWIDTH OPTIONAL
    !IV_PROVIDER TYPE /AWS1/NWMCONSTRAINEDSTRING OPTIONAL
    !IV_SITEID TYPE /AWS1/NWMSITEID OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_NWMTAG=>TT_TAGLIST OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_nwmcreatelinkresponse
  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_globalnetworkid TYPE /AWS1/NWMGLOBALNETWORKID /AWS1/NWMGLOBALNETWORKID

The ID of the global network.

io_bandwidth TYPE REF TO /AWS1/CL_NWMBANDWIDTH /AWS1/CL_NWMBANDWIDTH

The upload speed and download speed in Mbps.

iv_siteid TYPE /AWS1/NWMSITEID /AWS1/NWMSITEID

The ID of the site.

Optional arguments:

iv_description TYPE /AWS1/NWMCONSTRAINEDSTRING /AWS1/NWMCONSTRAINEDSTRING

A description of the link.

Constraints: Maximum length of 256 characters.

iv_type TYPE /AWS1/NWMCONSTRAINEDSTRING /AWS1/NWMCONSTRAINEDSTRING

The type of the link.

Constraints: Maximum length of 128 characters. Cannot include the following characters: | \ ^

iv_provider TYPE /AWS1/NWMCONSTRAINEDSTRING /AWS1/NWMCONSTRAINEDSTRING

The provider of the link.

Constraints: Maximum length of 128 characters. Cannot include the following characters: | \ ^

it_tags TYPE /AWS1/CL_NWMTAG=>TT_TAGLIST TT_TAGLIST

The tags to apply to the resource during creation.

RETURNING

oo_output TYPE REF TO /aws1/cl_nwmcreatelinkresponse /AWS1/CL_NWMCREATELINKRESPONSE

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->createlink(
  io_bandwidth = new /aws1/cl_nwmbandwidth(
    iv_downloadspeed = 123
    iv_uploadspeed = 123
  )
  it_tags = VALUE /aws1/cl_nwmtag=>tt_taglist(
    (
      new /aws1/cl_nwmtag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_description = |string|
  iv_globalnetworkid = |string|
  iv_provider = |string|
  iv_siteid = |string|
  iv_type = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_link = lo_result->get_link( ).
  IF lo_link IS NOT INITIAL.
    lv_linkid = lo_link->get_linkid( ).
    lv_linkarn = lo_link->get_linkarn( ).
    lv_globalnetworkid = lo_link->get_globalnetworkid( ).
    lv_siteid = lo_link->get_siteid( ).
    lv_constrainedstring = lo_link->get_description( ).
    lv_constrainedstring = lo_link->get_type( ).
    lo_bandwidth = lo_link->get_bandwidth( ).
    IF lo_bandwidth IS NOT INITIAL.
      lv_integer = lo_bandwidth->get_uploadspeed( ).
      lv_integer = lo_bandwidth->get_downloadspeed( ).
    ENDIF.
    lv_constrainedstring = lo_link->get_provider( ).
    lv_datetime = lo_link->get_createdat( ).
    lv_linkstate = lo_link->get_state( ).
    LOOP AT lo_link->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.
  ENDIF.
ENDIF.