Skip to content

/AWS1/IF_MHU=>NOTIFYMIGRATIONTASKSTATE()

About NotifyMigrationTaskState

Notifies Migration Hub of the current status, progress, or other detail regarding a migration task. This API has the following traits:

  • Migration tools will call the NotifyMigrationTaskState API to share the latest progress and status.

  • MigrationTaskName is used for addressing updates to the correct target.

  • ProgressUpdateStream is used for access control and to provide a namespace for each migration tool.

Method Signature

METHODS /AWS1/IF_MHU~NOTIFYMIGRATIONTASKSTATE
  IMPORTING
    !IV_PROGRESSUPDATESTREAM TYPE /AWS1/MHUPROGRESSUPDATESTREAM OPTIONAL
    !IV_MIGRATIONTASKNAME TYPE /AWS1/MHUMIGRATIONTASKNAME OPTIONAL
    !IO_TASK TYPE REF TO /AWS1/CL_MHUTASK OPTIONAL
    !IV_UPDATEDATETIME TYPE /AWS1/MHUUPDATEDATETIME OPTIONAL
    !IV_NEXTUPDATESECONDS TYPE /AWS1/MHUNEXTUPDATESECONDS OPTIONAL
    !IV_DRYRUN TYPE /AWS1/MHUDRYRUN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_mhunotifymigrationt01
  RAISING
    /AWS1/CX_MHUACCESSDENIEDEX
    /AWS1/CX_MHUDRYRUNOPERATION
    /AWS1/CX_MHUHOMEREGIONNOTSETEX
    /AWS1/CX_MHUINTERNALSERVERERR
    /AWS1/CX_MHUINVALIDINPUTEX
    /AWS1/CX_MHURESOURCENOTFOUNDEX
    /AWS1/CX_MHUSERVICEUNAVAILEX
    /AWS1/CX_MHUTHROTTLINGEX
    /AWS1/CX_MHUUNAUTHDOPERATION
    /AWS1/CX_MHUCLIENTEXC
    /AWS1/CX_MHUSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_progressupdatestream TYPE /AWS1/MHUPROGRESSUPDATESTREAM /AWS1/MHUPROGRESSUPDATESTREAM

The name of the ProgressUpdateStream.

iv_migrationtaskname TYPE /AWS1/MHUMIGRATIONTASKNAME /AWS1/MHUMIGRATIONTASKNAME

Unique identifier that references the migration task. Do not store personal data in this field.

io_task TYPE REF TO /AWS1/CL_MHUTASK /AWS1/CL_MHUTASK

Information about the task's progress and status.

iv_updatedatetime TYPE /AWS1/MHUUPDATEDATETIME /AWS1/MHUUPDATEDATETIME

The timestamp when the task was gathered.

iv_nextupdateseconds TYPE /AWS1/MHUNEXTUPDATESECONDS /AWS1/MHUNEXTUPDATESECONDS

Number of seconds after the UpdateDateTime within which the Migration Hub can expect an update. If Migration Hub does not receive an update within the specified interval, then the migration task will be considered stale.

Optional arguments:

iv_dryrun TYPE /AWS1/MHUDRYRUN /AWS1/MHUDRYRUN

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

RETURNING

oo_output TYPE REF TO /aws1/cl_mhunotifymigrationt01 /AWS1/CL_MHUNOTIFYMIGRATIONT01

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->notifymigrationtaskstate(
  io_task = new /aws1/cl_mhutask(
    iv_progresspercent = 123
    iv_status = |string|
    iv_statusdetail = |string|
  )
  iv_dryrun = ABAP_TRUE
  iv_migrationtaskname = |string|
  iv_nextupdateseconds = 123
  iv_progressupdatestream = |string|
  iv_updatedatetime = '20150101000000.0000000'
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
ENDIF.