/AWS1/IF_LSA=>PUTINSTANCEPUBLICPORTS()

About PutInstancePublicPorts

Opens ports for a specific Amazon Lightsail instance, and specifies the IP addresses allowed to connect to the instance through the ports, and the protocol. This action also closes all currently open ports that are not included in the request. Include all of the ports and the protocols you want to open in your PutInstancePublicPortsrequest. Or use the OpenInstancePublicPorts action to open ports without closing currently open ports.

The PutInstancePublicPorts action supports tag-based access control via resource tags applied to the resource identified by instanceName. For more information, see the Amazon Lightsail Developer Guide.

Method Signature

METHODS /AWS1/IF_LSA~PUTINSTANCEPUBLICPORTS
  IMPORTING
    !IT_PORTINFOS TYPE /AWS1/CL_LSAPORTINFO=>TT_PORTINFOLIST OPTIONAL
    !IV_INSTANCENAME TYPE /AWS1/LSARESOURCENAME OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_lsaputinstpubportsrs
  RAISING
    /AWS1/CX_LSAACCESSDENIEDEX
    /AWS1/CX_LSAACCTSETUPINPRGSSEX
    /AWS1/CX_LSAINVALIDINPUTEX
    /AWS1/CX_LSANOTFOUNDEXCEPTION
    /AWS1/CX_LSAOPERATIONFAILUREEX
    /AWS1/CX_LSARGNSETUPINPRGSSEX
    /AWS1/CX_LSASERVICEEXCEPTION
    /AWS1/CX_LSAUNAUTHNTCTDEX
    /AWS1/CX_LSACLIENTEXC
    /AWS1/CX_LSASERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

it_portinfos TYPE /AWS1/CL_LSAPORTINFO=>TT_PORTINFOLIST TT_PORTINFOLIST

An array of objects to describe the ports to open for the specified instance.

iv_instancename TYPE /AWS1/LSARESOURCENAME /AWS1/LSARESOURCENAME

The name of the instance for which to open ports.

RETURNING

oo_output TYPE REF TO /aws1/cl_lsaputinstpubportsrs /AWS1/CL_LSAPUTINSTPUBPORTSRS

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->putinstancepublicports(
  it_portinfos = VALUE /aws1/cl_lsaportinfo=>tt_portinfolist(
    (
      new /aws1/cl_lsaportinfo(
        it_cidrlistaliases = VALUE /aws1/cl_lsastringlist_w=>tt_stringlist(
          ( new /aws1/cl_lsastringlist_w( |string| ) )
        )
        it_cidrs = VALUE /aws1/cl_lsastringlist_w=>tt_stringlist(
          ( new /aws1/cl_lsastringlist_w( |string| ) )
        )
        it_ipv6cidrs = VALUE /aws1/cl_lsastringlist_w=>tt_stringlist(
          ( new /aws1/cl_lsastringlist_w( |string| ) )
        )
        iv_fromport = 123
        iv_protocol = |string|
        iv_toport = 123
      )
    )
  )
  iv_instancename = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_operation = lo_result->get_operation( ).
  IF lo_operation IS NOT INITIAL.
    lv_nonemptystring = lo_operation->get_id( ).
    lv_resourcename = lo_operation->get_resourcename( ).
    lv_resourcetype = lo_operation->get_resourcetype( ).
    lv_isodate = lo_operation->get_createdat( ).
    lo_resourcelocation = lo_operation->get_location( ).
    IF lo_resourcelocation IS NOT INITIAL.
      lv_string = lo_resourcelocation->get_availabilityzone( ).
      lv_regionname = lo_resourcelocation->get_regionname( ).
    ENDIF.
    lv_boolean = lo_operation->get_isterminal( ).
    lv_string = lo_operation->get_operationdetails( ).
    lv_operationtype = lo_operation->get_operationtype( ).
    lv_operationstatus = lo_operation->get_status( ).
    lv_isodate = lo_operation->get_statuschangedat( ).
    lv_string = lo_operation->get_errorcode( ).
    lv_string = lo_operation->get_errordetails( ).
  ENDIF.
ENDIF.