ASSOCIATECREATEDARTIFACT()`¶

About AssociateCreatedArtifact¶

Associates a created artifact of an AWS cloud resource, the target receiving the migration, with the migration task performed by a migration tool. This API has the following traits:

Migration tools can call the AssociateCreatedArtifact operation to indicate which AWS artifact is associated with a migration task.
The created artifact name must be provided in ARN (Amazon Resource Name) format which will contain information about type and region; for example: arn:aws:ec2:us-east-1:488216288981:image/ami-6d0ba87b.
Examples of the AWS resource behind the created artifact are, AMI's, EC2 instance, or DMS endpoint, etc.

Method Signature¶

METHODS /AWS1/IF_MHU~ASSOCIATECREATEDARTIFACT
  IMPORTING
    !IV_PROGRESSUPDATESTREAM TYPE /AWS1/MHUPROGRESSUPDATESTREAM OPTIONAL
    !IV_MIGRATIONTASKNAME TYPE /AWS1/MHUMIGRATIONTASKNAME OPTIONAL
    !IO_CREATEDARTIFACT TYPE REF TO /AWS1/CL_MHUCREATEDARTIFACT OPTIONAL
    !IV_DRYRUN TYPE /AWS1/MHUDRYRUN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_mhuassccredartifactrs
  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_createdartifact` `TYPE REF TO /AWS1/CL_MHUCREATEDARTIFACT` `/AWS1/CL_MHUCREATEDARTIFACT`¶

An ARN of the AWS resource related to the migration (e.g., AMI, EC2 instance, RDS instance, etc.)

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_mhuassccredartifactrs` `/AWS1/CL_MHUASSCCREDARTIFACTRS`¶

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->associatecreatedartifact(
  io_createdartifact = new /aws1/cl_mhucreatedartifact(
    iv_description = |string|
    iv_name = |string|
  )
  iv_dryrun = ABAP_TRUE
  iv_migrationtaskname = |string|
  iv_progressupdatestream = |string|
).

This is an example of reading all possible response values

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

/AWS1/IF_MHU=>ASSOCIATECREATEDARTIFACT()¶