Skip to content

/AWS1/IF_DMG=>MODIFYDATAMIGRATION()

About ModifyDataMigration

Modifies an existing DMS data migration.

Method Signature

METHODS /AWS1/IF_DMG~MODIFYDATAMIGRATION
  IMPORTING
    !IV_DATAMIGRATIONIDENTIFIER TYPE /AWS1/DMGSTRING OPTIONAL
    !IV_DATAMIGRATIONNAME TYPE /AWS1/DMGSTRING OPTIONAL
    !IV_ENABLECLOUDWATCHLOGS TYPE /AWS1/DMGBOOLEANOPTIONAL OPTIONAL
    !IV_SERVICEACCESSROLEARN TYPE /AWS1/DMGSTRING OPTIONAL
    !IV_DATAMIGRATIONTYPE TYPE /AWS1/DMGMIGRATIONTYPEVALUE OPTIONAL
    !IT_SOURCEDATASETTINGS TYPE /AWS1/CL_DMGSOURCEDATASETTING=>TT_SOURCEDATASETTINGS OPTIONAL
    !IT_TARGETDATASETTINGS TYPE /AWS1/CL_DMGTARGETDATASETTING=>TT_TARGETDATASETTINGS OPTIONAL
    !IV_NUMBEROFJOBS TYPE /AWS1/DMGINTEGEROPTIONAL OPTIONAL
    !IV_SELECTIONRULES TYPE /AWS1/DMGSECRETSTRING OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_dmgmoddatamigration01
  RAISING
    /AWS1/CX_DMGFAILEDDEPENDENCY00
    /AWS1/CX_DMGINVRESRCSTATEFAULT
    /AWS1/CX_DMGRESRCNOTFOUNDFAULT
    /AWS1/CX_DMGCLIENTEXC
    /AWS1/CX_DMGSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_datamigrationidentifier TYPE /AWS1/DMGSTRING /AWS1/DMGSTRING

The identifier (name or ARN) of the data migration to modify.

Optional arguments:

iv_datamigrationname TYPE /AWS1/DMGSTRING /AWS1/DMGSTRING

The new name for the data migration.

iv_enablecloudwatchlogs TYPE /AWS1/DMGBOOLEANOPTIONAL /AWS1/DMGBOOLEANOPTIONAL

Whether to enable Cloudwatch logs for the data migration.

iv_serviceaccessrolearn TYPE /AWS1/DMGSTRING /AWS1/DMGSTRING

The new service access role ARN for the data migration.

iv_datamigrationtype TYPE /AWS1/DMGMIGRATIONTYPEVALUE /AWS1/DMGMIGRATIONTYPEVALUE

The new migration type for the data migration.

it_sourcedatasettings TYPE /AWS1/CL_DMGSOURCEDATASETTING=>TT_SOURCEDATASETTINGS TT_SOURCEDATASETTINGS

The new information about the source data provider for the data migration.

it_targetdatasettings TYPE /AWS1/CL_DMGTARGETDATASETTING=>TT_TARGETDATASETTINGS TT_TARGETDATASETTINGS

The new information about the target data provider for the data migration.

iv_numberofjobs TYPE /AWS1/DMGINTEGEROPTIONAL /AWS1/DMGINTEGEROPTIONAL

The number of parallel jobs that trigger parallel threads to unload the tables from the source, and then load them to the target.

iv_selectionrules TYPE /AWS1/DMGSECRETSTRING /AWS1/DMGSECRETSTRING

A JSON-formatted string that defines what objects to include and exclude from the migration.

RETURNING

oo_output TYPE REF TO /aws1/cl_dmgmoddatamigration01 /AWS1/CL_DMGMODDATAMIGRATION01

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->modifydatamigration(
  it_sourcedatasettings = VALUE /aws1/cl_dmgsourcedatasetting=>tt_sourcedatasettings(
    (
      new /aws1/cl_dmgsourcedatasetting(
        iv_cdcstartposition = |string|
        iv_cdcstarttime = '20150101000000.0000000'
        iv_cdcstoptime = '20150101000000.0000000'
        iv_slotname = |string|
      )
    )
  )
  it_targetdatasettings = VALUE /aws1/cl_dmgtargetdatasetting=>tt_targetdatasettings(
    ( new /aws1/cl_dmgtargetdatasetting( |string| ) )
  )
  iv_datamigrationidentifier = |string|
  iv_datamigrationname = |string|
  iv_datamigrationtype = |string|
  iv_enablecloudwatchlogs = ABAP_TRUE
  iv_numberofjobs = 123
  iv_selectionrules = |string|
  iv_serviceaccessrolearn = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_datamigration = lo_result->get_datamigration( ).
  IF lo_datamigration IS NOT INITIAL.
    lv_string = lo_datamigration->get_datamigrationname( ).
    lv_string = lo_datamigration->get_datamigrationarn( ).
    lv_iso8601datetime = lo_datamigration->get_datamigrationcreatetime( ).
    lv_iso8601datetime = lo_datamigration->get_datamigrationstarttime( ).
    lv_iso8601datetime = lo_datamigration->get_datamigrationendtime( ).
    lv_string = lo_datamigration->get_serviceaccessrolearn( ).
    lv_string = lo_datamigration->get_migrationprojectarn( ).
    lv_migrationtypevalue = lo_datamigration->get_datamigrationtype( ).
    lo_datamigrationsettings = lo_datamigration->get_datamigrationsettings( ).
    IF lo_datamigrationsettings IS NOT INITIAL.
      lv_integeroptional = lo_datamigrationsettings->get_numberofjobs( ).
      lv_booleanoptional = lo_datamigrationsettings->get_cloudwatchlogsenabled( ).
      lv_secretstring = lo_datamigrationsettings->get_selectionrules( ).
    ENDIF.
    LOOP AT lo_datamigration->get_sourcedatasettings( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_string = lo_row_1->get_cdcstartposition( ).
        lv_iso8601datetime = lo_row_1->get_cdcstarttime( ).
        lv_iso8601datetime = lo_row_1->get_cdcstoptime( ).
        lv_string = lo_row_1->get_slotname( ).
      ENDIF.
    ENDLOOP.
    LOOP AT lo_datamigration->get_targetdatasettings( ) into lo_row_2.
      lo_row_3 = lo_row_2.
      IF lo_row_3 IS NOT INITIAL.
        lv_tablepreparationmode = lo_row_3->get_tablepreparationmode( ).
      ENDIF.
    ENDLOOP.
    lo_datamigrationstatistics = lo_datamigration->get_datamigrationstatistics( ).
    IF lo_datamigrationstatistics IS NOT INITIAL.
      lv_integer = lo_datamigrationstatistics->get_tablesloaded( ).
      lv_long = lo_datamigrationstatistics->get_elapsedtimemillis( ).
      lv_integer = lo_datamigrationstatistics->get_tablesloading( ).
      lv_integer = lo_datamigrationstatistics->get_fullloadpercentage( ).
      lv_integer = lo_datamigrationstatistics->get_cdclatency( ).
      lv_integer = lo_datamigrationstatistics->get_tablesqueued( ).
      lv_integer = lo_datamigrationstatistics->get_tableserrored( ).
      lv_iso8601datetime = lo_datamigrationstatistics->get_starttime( ).
      lv_iso8601datetime = lo_datamigrationstatistics->get_stoptime( ).
    ENDIF.
    lv_string = lo_datamigration->get_datamigrationstatus( ).
    LOOP AT lo_datamigration->get_publicipaddresses( ) into lo_row_4.
      lo_row_5 = lo_row_4.
      IF lo_row_5 IS NOT INITIAL.
        lv_string = lo_row_5->get_value( ).
      ENDIF.
    ENDLOOP.
    LOOP AT lo_datamigration->get_datamigrationcidrblocks( ) into lo_row_6.
      lo_row_7 = lo_row_6.
      IF lo_row_7 IS NOT INITIAL.
        lv_string = lo_row_7->get_value( ).
      ENDIF.
    ENDLOOP.
    lv_string = lo_datamigration->get_lastfailuremessage( ).
    lv_string = lo_datamigration->get_stopreason( ).
  ENDIF.
ENDIF.