Skip to content

/AWS1/IF_MGN=>UPDATELAUNCHCONFIGURATION()

About UpdateLaunchConfiguration

Updates multiple LaunchConfigurations by Source Server ID.

bootMode valid values are LEGACY_BIOS | UEFI

Method Signature

METHODS /AWS1/IF_MGN~UPDATELAUNCHCONFIGURATION
  IMPORTING
    !IV_SOURCESERVERID TYPE /AWS1/MGNSOURCESERVERID OPTIONAL
    !IV_NAME TYPE /AWS1/MGNSMALLBOUNDEDSTRING OPTIONAL
    !IV_LAUNCHDISPOSITION TYPE /AWS1/MGNLAUNCHDISPOSITION OPTIONAL
    !IV_TGTINSTTYPERIGHTSIZINGMTH TYPE /AWS1/MGNTGTINSTTYPERIGHTSIZ00 OPTIONAL
    !IV_COPYPRIVATEIP TYPE /AWS1/MGNBOOLEAN OPTIONAL
    !IV_COPYTAGS TYPE /AWS1/MGNBOOLEAN OPTIONAL
    !IO_LICENSING TYPE REF TO /AWS1/CL_MGNLICENSING OPTIONAL
    !IV_BOOTMODE TYPE /AWS1/MGNBOOTMODE OPTIONAL
    !IO_POSTLAUNCHACTIONS TYPE REF TO /AWS1/CL_MGNPOSTLAUNCHACTIONS OPTIONAL
    !IV_ENABLEMAPAUTOTAGGING TYPE /AWS1/MGNBOOLEAN OPTIONAL
    !IV_MAPAUTOTAGGINGMPEID TYPE /AWS1/MGNTAGVALUE OPTIONAL
    !IV_ACCOUNTID TYPE /AWS1/MGNACCOUNTID OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_mgnlaunchconf
  RAISING
    /AWS1/CX_MGNCONFLICTEXCEPTION
    /AWS1/CX_MGNRESOURCENOTFOUNDEX
    /AWS1/CX_MGNUNINITIALIZEDACEX
    /AWS1/CX_MGNVALIDATIONEX
    /AWS1/CX_MGNCLIENTEXC
    /AWS1/CX_MGNSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_sourceserverid TYPE /AWS1/MGNSOURCESERVERID /AWS1/MGNSOURCESERVERID

Update Launch configuration by Source Server ID request.

Optional arguments:

iv_name TYPE /AWS1/MGNSMALLBOUNDEDSTRING /AWS1/MGNSMALLBOUNDEDSTRING

Update Launch configuration name request.

iv_launchdisposition TYPE /AWS1/MGNLAUNCHDISPOSITION /AWS1/MGNLAUNCHDISPOSITION

Update Launch configuration launch disposition request.

iv_tgtinsttyperightsizingmth TYPE /AWS1/MGNTGTINSTTYPERIGHTSIZ00 /AWS1/MGNTGTINSTTYPERIGHTSIZ00

Update Launch configuration Target instance right sizing request.

iv_copyprivateip TYPE /AWS1/MGNBOOLEAN /AWS1/MGNBOOLEAN

Update Launch configuration copy Private IP request.

iv_copytags TYPE /AWS1/MGNBOOLEAN /AWS1/MGNBOOLEAN

Update Launch configuration copy Tags request.

io_licensing TYPE REF TO /AWS1/CL_MGNLICENSING /AWS1/CL_MGNLICENSING

Update Launch configuration licensing request.

iv_bootmode TYPE /AWS1/MGNBOOTMODE /AWS1/MGNBOOTMODE

Update Launch configuration boot mode request.

io_postlaunchactions TYPE REF TO /AWS1/CL_MGNPOSTLAUNCHACTIONS /AWS1/CL_MGNPOSTLAUNCHACTIONS

Post Launch Actions to executed on the Test or Cutover instance.

iv_enablemapautotagging TYPE /AWS1/MGNBOOLEAN /AWS1/MGNBOOLEAN

Enable map auto tagging.

iv_mapautotaggingmpeid TYPE /AWS1/MGNTAGVALUE /AWS1/MGNTAGVALUE

Launch configuration map auto tagging MPE ID.

iv_accountid TYPE /AWS1/MGNACCOUNTID /AWS1/MGNACCOUNTID

Update Launch configuration Account ID.

RETURNING

oo_output TYPE REF TO /aws1/cl_mgnlaunchconf /AWS1/CL_MGNLAUNCHCONF

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->updatelaunchconfiguration(
  io_licensing = new /aws1/cl_mgnlicensing( ABAP_TRUE )
  io_postlaunchactions = new /aws1/cl_mgnpostlaunchactions(
    it_ssmdocuments = VALUE /aws1/cl_mgnssmdocument=>tt_ssmdocuments(
      (
        new /aws1/cl_mgnssmdocument(
          it_externalparameters = VALUE /aws1/cl_mgnssmexternalparam=>tt_ssmdocumentexternalparams(
            (
              VALUE /aws1/cl_mgnssmexternalparam=>ts_ssmdocexternalparams_maprow(
                value = new /aws1/cl_mgnssmexternalparam( |string| )
                key = |string|
              )
            )
          )
          it_parameters = VALUE /aws1/cl_mgnssmparamstoreparam=>tt_ssmdocumentparameters(
            (
              VALUE /aws1/cl_mgnssmparamstoreparam=>ts_ssmdocumentparams_maprow(
                key = |string|
                value = VALUE /aws1/cl_mgnssmparamstoreparam=>tt_ssmparameterstoreparameters(
                  (
                    new /aws1/cl_mgnssmparamstoreparam(
                      iv_parametername = |string|
                      iv_parametertype = |string|
                    )
                  )
                )
              )
            )
          )
          iv_actionname = |string|
          iv_mustsucceedforcutover = ABAP_TRUE
          iv_ssmdocumentname = |string|
          iv_timeoutseconds = 123
        )
      )
    )
    iv_cloudwatchloggroupname = |string|
    iv_deployment = |string|
    iv_s3logbucket = |string|
    iv_s3outputkeyprefix = |string|
  )
  iv_accountid = |string|
  iv_bootmode = |string|
  iv_copyprivateip = ABAP_TRUE
  iv_copytags = ABAP_TRUE
  iv_enablemapautotagging = ABAP_TRUE
  iv_launchdisposition = |string|
  iv_mapautotaggingmpeid = |string|
  iv_name = |string|
  iv_sourceserverid = |string|
  iv_tgtinsttyperightsizingmth = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_sourceserverid = lo_result->get_sourceserverid( ).
  lv_smallboundedstring = lo_result->get_name( ).
  lv_boundedstring = lo_result->get_ec2launchtemplateid( ).
  lv_launchdisposition = lo_result->get_launchdisposition( ).
  lv_targetinstancetyperight = lo_result->get_tgtinsttyperightsizing00( ).
  lv_boolean = lo_result->get_copyprivateip( ).
  lv_boolean = lo_result->get_copytags( ).
  lo_licensing = lo_result->get_licensing( ).
  IF lo_licensing IS NOT INITIAL.
    lv_boolean = lo_licensing->get_osbyol( ).
  ENDIF.
  lv_bootmode = lo_result->get_bootmode( ).
  lo_postlaunchactions = lo_result->get_postlaunchactions( ).
  IF lo_postlaunchactions IS NOT INITIAL.
    lv_postlaunchactionsdeploy = lo_postlaunchactions->get_deployment( ).
    lv_s3logbucketname = lo_postlaunchactions->get_s3logbucket( ).
    lv_boundedstring = lo_postlaunchactions->get_s3outputkeyprefix( ).
    lv_cloudwatchloggroupname = lo_postlaunchactions->get_cloudwatchloggroupname( ).
    LOOP AT lo_postlaunchactions->get_ssmdocuments( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_boundedstring = lo_row_1->get_actionname( ).
        lv_ssmdocumentname = lo_row_1->get_ssmdocumentname( ).
        lv_strictlypositiveinteger = lo_row_1->get_timeoutseconds( ).
        lv_boolean = lo_row_1->get_mustsucceedforcutover( ).
        LOOP AT lo_row_1->get_parameters( ) into ls_row_2.
          lv_key = ls_row_2-key.
          LOOP AT ls_row_2-value into lo_row_3.
            lo_row_4 = lo_row_3.
            IF lo_row_4 IS NOT INITIAL.
              lv_ssmparameterstoreparame = lo_row_4->get_parametertype( ).
              lv_ssmparameterstoreparame_1 = lo_row_4->get_parametername( ).
            ENDIF.
          ENDLOOP.
        ENDLOOP.
        LOOP AT lo_row_1->get_externalparameters( ) into ls_row_5.
          lv_key = ls_row_5-key.
          lo_value = ls_row_5-value.
          IF lo_value IS NOT INITIAL.
            lv_jmespathstring = lo_value->get_dynamicpath( ).
          ENDIF.
        ENDLOOP.
      ENDIF.
    ENDLOOP.
  ENDIF.
  lv_boolean = lo_result->get_enablemapautotagging( ).
  lv_tagvalue = lo_result->get_mapautotaggingmpeid( ).
ENDIF.