STARTMIGRATION()`¶

About StartMigration¶

Starts migrating a bot from Amazon Lex V1 to Amazon Lex V2. Migrate your bot when you want to take advantage of the new features of Amazon Lex V2.

For more information, see Migrating a bot in the Amazon Lex developer guide.

Method Signature¶

METHODS /AWS1/IF_LXB~STARTMIGRATION
  IMPORTING
    !IV_V1BOTNAME TYPE /AWS1/LXBBOTNAME OPTIONAL
    !IV_V1BOTVERSION TYPE /AWS1/LXBVERSION OPTIONAL
    !IV_V2BOTNAME TYPE /AWS1/LXBV2BOTNAME OPTIONAL
    !IV_V2BOTROLE TYPE /AWS1/LXBIAMROLEARN OPTIONAL
    !IV_MIGRATIONSTRATEGY TYPE /AWS1/LXBMIGRATIONSTRATEGY OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_lxbstartmigrationrsp
  RAISING
    /AWS1/CX_LXBACCESSDENIEDEX
    /AWS1/CX_LXBBADREQUESTEX
    /AWS1/CX_LXBINTERNALFAILUREEX
    /AWS1/CX_LXBLIMITEXCEEDEDEX
    /AWS1/CX_LXBNOTFOUNDEXCEPTION
    /AWS1/CX_LXBCLIENTEXC
    /AWS1/CX_LXBSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_v1botname` `TYPE /AWS1/LXBBOTNAME` `/AWS1/LXBBOTNAME`¶

The name of the Amazon Lex V1 bot that you are migrating to Amazon Lex V2.

`iv_v1botversion` `TYPE /AWS1/LXBVERSION` `/AWS1/LXBVERSION`¶

The version of the bot to migrate to Amazon Lex V2. You can migrate the $LATEST version as well as any numbered version.

`iv_v2botname` `TYPE /AWS1/LXBV2BOTNAME` `/AWS1/LXBV2BOTNAME`¶

The name of the Amazon Lex V2 bot that you are migrating the Amazon Lex V1 bot to.

If the Amazon Lex V2 bot doesn't exist, you must use the CREATE_NEW migration strategy.

If the Amazon Lex V2 bot exists, you must use the UPDATE_EXISTING migration strategy to change the contents of the Amazon Lex V2 bot.

`iv_v2botrole` `TYPE /AWS1/LXBIAMROLEARN` `/AWS1/LXBIAMROLEARN`¶

The IAM role that Amazon Lex uses to run the Amazon Lex V2 bot.

`iv_migrationstrategy` `TYPE /AWS1/LXBMIGRATIONSTRATEGY` `/AWS1/LXBMIGRATIONSTRATEGY`¶

The strategy used to conduct the migration.

CREATE_NEW - Creates a new Amazon Lex V2 bot and migrates the Amazon Lex V1 bot to the new bot.

UPDATE_EXISTING - Overwrites the existing Amazon Lex V2 bot metadata and the locale being migrated. It doesn't change any other locales in the Amazon Lex V2 bot. If the locale doesn't exist, a new locale is created in the Amazon Lex V2 bot.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_lxbstartmigrationrsp` `/AWS1/CL_LXBSTARTMIGRATIONRSP`¶

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->startmigration(
  iv_migrationstrategy = |string|
  iv_v1botname = |string|
  iv_v1botversion = |string|
  iv_v2botname = |string|
  iv_v2botrole = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_botname = lo_result->get_v1botname( ).
  lv_version = lo_result->get_v1botversion( ).
  lv_locale = lo_result->get_v1botlocale( ).
  lv_v2botid = lo_result->get_v2botid( ).
  lv_iamrolearn = lo_result->get_v2botrole( ).
  lv_migrationid = lo_result->get_migrationid( ).
  lv_migrationstrategy = lo_result->get_migrationstrategy( ).
  lv_timestamp = lo_result->get_migrationtimestamp( ).
ENDIF.

/AWS1/IF_LXB=>STARTMIGRATION()¶