CREATEDEPLOYMENTJOB()`¶

About CreateDeploymentJob¶

End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker. After September 10, 2025, you will no longer be able to access the Amazon Web Services RoboMaker console or Amazon Web Services RoboMaker resources. For more information on transitioning to Batch to help run containerized simulations, visit https://aws.amazon.com/blogs/hpc/run-simulations-using-multiple-containers-in-a-single-aws-batch-job/.

This API is no longer supported and will throw an error if used. For more information, see the January 31, 2022 update in the Support policy page.

Deploys a specific version of a robot application to robots in a fleet.

The robot application must have a numbered applicationVersion for consistency reasons. To create a new version, use CreateRobotApplicationVersion or see Creating a Robot Application Version.

After 90 days, deployment jobs expire and will be deleted. They will no longer be accessible.

Method Signature¶

IMPORTING¶

Required arguments:¶

`iv_clientrequesttoken` `TYPE /AWS1/RBMCLIENTREQUESTTOKEN` `/AWS1/RBMCLIENTREQUESTTOKEN`¶

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

`iv_fleet` `TYPE /AWS1/RBMARN` `/AWS1/RBMARN`¶

The Amazon Resource Name (ARN) of the fleet to deploy.

`it_deploymentapplicationcfgs` `TYPE /AWS1/CL_RBMDEPLOYMENTAPPLIC00=>TT_DEPLOYMENTAPPLICATIONCFGS` `TT_DEPLOYMENTAPPLICATIONCFGS`¶

The deployment application configuration.

Optional arguments:¶

`io_deploymentconfig` `TYPE REF TO /AWS1/CL_RBMDEPLOYMENTCONFIG` `/AWS1/CL_RBMDEPLOYMENTCONFIG`¶

The requested deployment configuration.

`it_tags` `TYPE /AWS1/CL_RBMTAGMAP_W=>TT_TAGMAP` `TT_TAGMAP`¶

A map that contains tag keys and tag values that are attached to the deployment job.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_rbmcredeploymentjob01` `/AWS1/CL_RBMCREDEPLOYMENTJOB01`¶

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->/aws1/if_rbm~createdeploymentjob(
  io_deploymentconfig = new /aws1/cl_rbmdeploymentconfig(
    io_downloadconditionfile = new /aws1/cl_rbms3object(
      iv_bucket = |string|
      iv_etag = |string|
      iv_key = |string|
    )
    iv_concurrentdeploymentper00 = 123
    iv_failurethreshpercentage = 123
    iv_robotdeploymenttmoutins00 = 123
  )
  it_deploymentapplicationcfgs = VALUE /aws1/cl_rbmdeploymentapplic00=>tt_deploymentapplicationcfgs(
    (
      new /aws1/cl_rbmdeploymentapplic00(
        io_launchconfig = new /aws1/cl_rbmdeploymentlaunch00(
          it_environmentvariables = VALUE /aws1/cl_rbmenvironmentvaria00=>tt_environmentvariablemap(
            (
              VALUE /aws1/cl_rbmenvironmentvaria00=>ts_environmentvariabl00_maprow(
                value = new /aws1/cl_rbmenvironmentvaria00( |string| )
                key = |string|
              )
            )
          )
          iv_launchfile = |string|
          iv_packagename = |string|
          iv_postlaunchfile = |string|
          iv_prelaunchfile = |string|
        )
        iv_application = |string|
        iv_applicationversion = |string|
      )
    )
  )
  it_tags = VALUE /aws1/cl_rbmtagmap_w=>tt_tagmap(
    (
      VALUE /aws1/cl_rbmtagmap_w=>ts_tagmap_maprow(
        value = new /aws1/cl_rbmtagmap_w( |string| )
        key = |string|
      )
    )
  )
  iv_clientrequesttoken = |string|
  iv_fleet = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_arn = lo_result->get_arn( ).
  lv_arn = lo_result->get_fleet( ).
  lv_deploymentstatus = lo_result->get_status( ).
  LOOP AT lo_result->get_deploymentapplicationc00( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_arn = lo_row_1->get_application( ).
      lv_deploymentversion = lo_row_1->get_applicationversion( ).
      lo_deploymentlaunchconfig = lo_row_1->get_launchconfig( ).
      IF lo_deploymentlaunchconfig IS NOT INITIAL.
        lv_command = lo_deploymentlaunchconfig->get_packagename( ).
        lv_path = lo_deploymentlaunchconfig->get_prelaunchfile( ).
        lv_command = lo_deploymentlaunchconfig->get_launchfile( ).
        lv_path = lo_deploymentlaunchconfig->get_postlaunchfile( ).
        LOOP AT lo_deploymentlaunchconfig->get_environmentvariables( ) into ls_row_2.
          lv_key = ls_row_2-key.
          lo_value = ls_row_2-value.
          IF lo_value IS NOT INITIAL.
            lv_environmentvariablevalu = lo_value->get_value( ).
          ENDIF.
        ENDLOOP.
      ENDIF.
    ENDIF.
  ENDLOOP.
  lv_genericstring = lo_result->get_failurereason( ).
  lv_deploymentjoberrorcode = lo_result->get_failurecode( ).
  lv_createdat = lo_result->get_createdat( ).
  lo_deploymentconfig = lo_result->get_deploymentconfig( ).
  IF lo_deploymentconfig IS NOT INITIAL.
    lv_percentage = lo_deploymentconfig->get_concurrentdeploymentpe00( ).
    lv_percentage = lo_deploymentconfig->get_failurethreshpercentage( ).
    lv_deploymenttimeout = lo_deploymentconfig->get_robotdeploymenttmoutin00( ).
    lo_s3object = lo_deploymentconfig->get_downloadconditionfile( ).
    IF lo_s3object IS NOT INITIAL.
      lv_s3bucket = lo_s3object->get_bucket( ).
      lv_s3key = lo_s3object->get_key( ).
      lv_s3etag = lo_s3object->get_etag( ).
    ENDIF.
  ENDIF.
  LOOP AT lo_result->get_tags( ) into ls_row_3.
    lv_key_1 = ls_row_3-key.
    lo_value_1 = ls_row_3-value.
    IF lo_value_1 IS NOT INITIAL.
      lv_tagvalue = lo_value_1->get_value( ).
    ENDIF.
  ENDLOOP.
ENDIF.

/AWS1/CL_RBM=>CREATEDEPLOYMENTJOB()¶