/AWS1/IF_RBM=>CREATESIMULATIONJOB()¶
About CreateSimulationJob¶
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/.
Creates a simulation job.
After 90 days, simulation jobs expire and will be deleted. They will no longer be accessible.
Method Signature¶
METHODS /AWS1/IF_RBM~CREATESIMULATIONJOB
IMPORTING
!IV_CLIENTREQUESTTOKEN TYPE /AWS1/RBMCLIENTREQUESTTOKEN OPTIONAL
!IO_OUTPUTLOCATION TYPE REF TO /AWS1/CL_RBMOUTPUTLOCATION OPTIONAL
!IO_LOGGINGCONFIG TYPE REF TO /AWS1/CL_RBMLOGGINGCONFIG OPTIONAL
!IV_MAXJOBDURATIONINSECONDS TYPE /AWS1/RBMJOBDURATION OPTIONAL
!IV_IAMROLE TYPE /AWS1/RBMIAMROLE OPTIONAL
!IV_FAILUREBEHAVIOR TYPE /AWS1/RBMFAILUREBEHAVIOR OPTIONAL
!IT_ROBOTAPPLICATIONS TYPE /AWS1/CL_RBMROBOTAPPLICATION00=>TT_ROBOTAPPLICATIONCONFIGS OPTIONAL
!IT_SIMULATIONAPPLICATIONS TYPE /AWS1/CL_RBMSIMULATIONAPPLIC00=>TT_SIMULATIONAPPLICATIONCFGS OPTIONAL
!IT_DATASOURCES TYPE /AWS1/CL_RBMDATASOURCECONFIG=>TT_DATASOURCECONFIGS OPTIONAL
!IT_TAGS TYPE /AWS1/CL_RBMTAGMAP_W=>TT_TAGMAP OPTIONAL
!IO_VPCCONFIG TYPE REF TO /AWS1/CL_RBMVPCCONFIG OPTIONAL
!IO_COMPUTE TYPE REF TO /AWS1/CL_RBMCOMPUTE OPTIONAL
RETURNING
VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_rbmcresimulationjob01
RAISING
/AWS1/CX_RBMIDEMPOTENTPRMMIS00
/AWS1/CX_RBMINTERNALSERVEREX
/AWS1/CX_RBMINVALIDPARAMETEREX
/AWS1/CX_RBMLIMITEXCEEDEDEX
/AWS1/CX_RBMRESOURCENOTFOUNDEX
/AWS1/CX_RBMSERVICEUNAVAILEX
/AWS1/CX_RBMTHROTTLINGEX
/AWS1/CX_RBMCLIENTEXC
/AWS1/CX_RBMSERVEREXC
/AWS1/CX_RT_TECHNICAL_GENERIC
/AWS1/CX_RT_SERVICE_GENERIC.
IMPORTING¶
Required arguments:¶
iv_maxjobdurationinseconds TYPE /AWS1/RBMJOBDURATION /AWS1/RBMJOBDURATION¶
The maximum simulation job duration in seconds (up to 14 days or 1,209,600 seconds. When
maxJobDurationInSecondsis reached, the simulation job will status will transition toCompleted.
iv_iamrole TYPE /AWS1/RBMIAMROLE /AWS1/RBMIAMROLE¶
The IAM role name that allows the simulation instance to call the AWS APIs that are specified in its associated policies on your behalf. This is how credentials are passed in to your simulation job.
Optional arguments:¶
iv_clientrequesttoken TYPE /AWS1/RBMCLIENTREQUESTTOKEN /AWS1/RBMCLIENTREQUESTTOKEN¶
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
io_outputlocation TYPE REF TO /AWS1/CL_RBMOUTPUTLOCATION /AWS1/CL_RBMOUTPUTLOCATION¶
Location for output files generated by the simulation job.
io_loggingconfig TYPE REF TO /AWS1/CL_RBMLOGGINGCONFIG /AWS1/CL_RBMLOGGINGCONFIG¶
The logging configuration.
iv_failurebehavior TYPE /AWS1/RBMFAILUREBEHAVIOR /AWS1/RBMFAILUREBEHAVIOR¶
The failure behavior the simulation job.
- Continue
Leaves the instance running for its maximum timeout duration after a
4XXerror code.- Fail
Stop the simulation job and terminate the instance.
it_robotapplications TYPE /AWS1/CL_RBMROBOTAPPLICATION00=>TT_ROBOTAPPLICATIONCONFIGS TT_ROBOTAPPLICATIONCONFIGS¶
The robot application to use in the simulation job.
it_simulationapplications TYPE /AWS1/CL_RBMSIMULATIONAPPLIC00=>TT_SIMULATIONAPPLICATIONCFGS TT_SIMULATIONAPPLICATIONCFGS¶
The simulation application to use in the simulation job.
it_datasources TYPE /AWS1/CL_RBMDATASOURCECONFIG=>TT_DATASOURCECONFIGS TT_DATASOURCECONFIGS¶
Specify data sources to mount read-only files from S3 into your simulation. These files are available under
/opt/robomaker/datasources/data_source_name.There is a limit of 100 files and a combined size of 25GB for all
DataSourceConfigobjects.
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 simulation job.
io_vpcconfig TYPE REF TO /AWS1/CL_RBMVPCCONFIG /AWS1/CL_RBMVPCCONFIG¶
If your simulation job accesses resources in a VPC, you provide this parameter identifying the list of security group IDs and subnet IDs. These must belong to the same VPC. You must provide at least one security group and one subnet ID.
io_compute TYPE REF TO /AWS1/CL_RBMCOMPUTE /AWS1/CL_RBMCOMPUTE¶
Compute information for the simulation job.
RETURNING¶
oo_output TYPE REF TO /aws1/cl_rbmcresimulationjob01 /AWS1/CL_RBMCRESIMULATIONJOB01¶
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->createsimulationjob(
io_compute = new /aws1/cl_rbmcompute(
iv_computetype = |string|
iv_gpuunitlimit = 123
iv_simulationunitlimit = 123
)
io_loggingconfig = new /aws1/cl_rbmloggingconfig( ABAP_TRUE )
io_outputlocation = new /aws1/cl_rbmoutputlocation(
iv_s3bucket = |string|
iv_s3prefix = |string|
)
io_vpcconfig = new /aws1/cl_rbmvpcconfig(
it_securitygroups = VALUE /aws1/cl_rbmsecuritygroups_w=>tt_securitygroups(
( new /aws1/cl_rbmsecuritygroups_w( |string| ) )
)
it_subnets = VALUE /aws1/cl_rbmsubnets_w=>tt_subnets(
( new /aws1/cl_rbmsubnets_w( |string| ) )
)
iv_assignpublicip = ABAP_TRUE
)
it_datasources = VALUE /aws1/cl_rbmdatasourceconfig=>tt_datasourceconfigs(
(
new /aws1/cl_rbmdatasourceconfig(
it_s3keys = VALUE /aws1/cl_rbms3keysorprefixes_w=>tt_s3keysorprefixes(
( new /aws1/cl_rbms3keysorprefixes_w( |string| ) )
)
iv_destination = |string|
iv_name = |string|
iv_s3bucket = |string|
iv_type = |string|
)
)
)
it_robotapplications = VALUE /aws1/cl_rbmrobotapplication00=>tt_robotapplicationconfigs(
(
new /aws1/cl_rbmrobotapplication00(
io_launchconfig = new /aws1/cl_rbmlaunchconfig(
io_portforwardingconfig = new /aws1/cl_rbmportforwardingcfg(
it_portmappings = VALUE /aws1/cl_rbmportmapping=>tt_portmappinglist(
(
new /aws1/cl_rbmportmapping(
iv_applicationport = 123
iv_enableonpublicip = ABAP_TRUE
iv_jobport = 123
)
)
)
)
it_command = VALUE /aws1/cl_rbmcommandlist_w=>tt_commandlist(
( new /aws1/cl_rbmcommandlist_w( |string| ) )
)
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_streamui = ABAP_TRUE
)
it_tools = VALUE /aws1/cl_rbmtool=>tt_tools(
(
new /aws1/cl_rbmtool(
iv_command = |string|
iv_exitbehavior = |string|
iv_name = |string|
iv_streamoutputtocloudwatch = ABAP_TRUE
iv_streamui = ABAP_TRUE
)
)
)
it_uploadconfigurations = VALUE /aws1/cl_rbmuploadconf=>tt_uploadconfigurations(
(
new /aws1/cl_rbmuploadconf(
iv_name = |string|
iv_path = |string|
iv_uploadbehavior = |string|
)
)
)
iv_application = |string|
iv_applicationversion = |string|
iv_usedefaulttools = ABAP_TRUE
iv_usedefaultuploadconfs = ABAP_TRUE
)
)
)
it_simulationapplications = VALUE /aws1/cl_rbmsimulationapplic00=>tt_simulationapplicationcfgs(
(
new /aws1/cl_rbmsimulationapplic00(
io_launchconfig = new /aws1/cl_rbmlaunchconfig(
io_portforwardingconfig = new /aws1/cl_rbmportforwardingcfg(
it_portmappings = VALUE /aws1/cl_rbmportmapping=>tt_portmappinglist(
(
new /aws1/cl_rbmportmapping(
iv_applicationport = 123
iv_enableonpublicip = ABAP_TRUE
iv_jobport = 123
)
)
)
)
it_command = VALUE /aws1/cl_rbmcommandlist_w=>tt_commandlist(
( new /aws1/cl_rbmcommandlist_w( |string| ) )
)
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_streamui = ABAP_TRUE
)
it_tools = VALUE /aws1/cl_rbmtool=>tt_tools(
(
new /aws1/cl_rbmtool(
iv_command = |string|
iv_exitbehavior = |string|
iv_name = |string|
iv_streamoutputtocloudwatch = ABAP_TRUE
iv_streamui = ABAP_TRUE
)
)
)
it_uploadconfigurations = VALUE /aws1/cl_rbmuploadconf=>tt_uploadconfigurations(
(
new /aws1/cl_rbmuploadconf(
iv_name = |string|
iv_path = |string|
iv_uploadbehavior = |string|
)
)
)
it_worldconfigs = VALUE /aws1/cl_rbmworldconfig=>tt_worldconfigs(
( new /aws1/cl_rbmworldconfig( |string| ) )
)
iv_application = |string|
iv_applicationversion = |string|
iv_usedefaulttools = ABAP_TRUE
iv_usedefaultuploadconfs = ABAP_TRUE
)
)
)
it_tags = VALUE /aws1/cl_rbmtagmap_w=>tt_tagmap(
(
VALUE /aws1/cl_rbmtagmap_w=>ts_tagmap_maprow(
key = |string|
value = new /aws1/cl_rbmtagmap_w( |string| )
)
)
)
iv_clientrequesttoken = |string|
iv_failurebehavior = |string|
iv_iamrole = |string|
iv_maxjobdurationinseconds = 123
).
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_simulationjobstatus = lo_result->get_status( ).
lv_laststartedat = lo_result->get_laststartedat( ).
lv_lastupdatedat = lo_result->get_lastupdatedat( ).
lv_failurebehavior = lo_result->get_failurebehavior( ).
lv_simulationjoberrorcode = lo_result->get_failurecode( ).
lv_clientrequesttoken = lo_result->get_clientrequesttoken( ).
lo_outputlocation = lo_result->get_outputlocation( ).
IF lo_outputlocation IS NOT INITIAL.
lv_s3bucket = lo_outputlocation->get_s3bucket( ).
lv_s3key = lo_outputlocation->get_s3prefix( ).
ENDIF.
lo_loggingconfig = lo_result->get_loggingconfig( ).
IF lo_loggingconfig IS NOT INITIAL.
lv_boxedboolean = lo_loggingconfig->get_recordallrostopics( ).
ENDIF.
lv_jobduration = lo_result->get_maxjobdurationinseconds( ).
lv_simulationtimemillis = lo_result->get_simulationtimemillis( ).
lv_iamrole = lo_result->get_iamrole( ).
LOOP AT lo_result->get_robotapplications( ) into lo_row.
lo_row_1 = lo_row.
IF lo_row_1 IS NOT INITIAL.
lv_arn = lo_row_1->get_application( ).
lv_version = lo_row_1->get_applicationversion( ).
lo_launchconfig = lo_row_1->get_launchconfig( ).
IF lo_launchconfig IS NOT INITIAL.
lv_command = lo_launchconfig->get_packagename( ).
lv_command = lo_launchconfig->get_launchfile( ).
LOOP AT lo_launchconfig->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.
lo_portforwardingconfig = lo_launchconfig->get_portforwardingconfig( ).
IF lo_portforwardingconfig IS NOT INITIAL.
LOOP AT lo_portforwardingconfig->get_portmappings( ) into lo_row_3.
lo_row_4 = lo_row_3.
IF lo_row_4 IS NOT INITIAL.
lv_port = lo_row_4->get_jobport( ).
lv_nonsystemport = lo_row_4->get_applicationport( ).
lv_boolean = lo_row_4->get_enableonpublicip( ).
ENDIF.
ENDLOOP.
ENDIF.
lv_boolean = lo_launchconfig->get_streamui( ).
LOOP AT lo_launchconfig->get_command( ) into lo_row_5.
lo_row_6 = lo_row_5.
IF lo_row_6 IS NOT INITIAL.
lv_nonemptystring = lo_row_6->get_value( ).
ENDIF.
ENDLOOP.
ENDIF.
LOOP AT lo_row_1->get_uploadconfigurations( ) into lo_row_7.
lo_row_8 = lo_row_7.
IF lo_row_8 IS NOT INITIAL.
lv_name = lo_row_8->get_name( ).
lv_path = lo_row_8->get_path( ).
lv_uploadbehavior = lo_row_8->get_uploadbehavior( ).
ENDIF.
ENDLOOP.
lv_boxedboolean = lo_row_1->get_usedefaultuploadconfs( ).
LOOP AT lo_row_1->get_tools( ) into lo_row_9.
lo_row_10 = lo_row_9.
IF lo_row_10 IS NOT INITIAL.
lv_boxedboolean = lo_row_10->get_streamui( ).
lv_name = lo_row_10->get_name( ).
lv_unrestrictedcommand = lo_row_10->get_command( ).
lv_boxedboolean = lo_row_10->get_streamoutputtocloudwatch( ).
lv_exitbehavior = lo_row_10->get_exitbehavior( ).
ENDIF.
ENDLOOP.
lv_boxedboolean = lo_row_1->get_usedefaulttools( ).
ENDIF.
ENDLOOP.
LOOP AT lo_result->get_simulationapplications( ) into lo_row_11.
lo_row_12 = lo_row_11.
IF lo_row_12 IS NOT INITIAL.
lv_arn = lo_row_12->get_application( ).
lv_version = lo_row_12->get_applicationversion( ).
lo_launchconfig = lo_row_12->get_launchconfig( ).
IF lo_launchconfig IS NOT INITIAL.
lv_command = lo_launchconfig->get_packagename( ).
lv_command = lo_launchconfig->get_launchfile( ).
LOOP AT lo_launchconfig->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.
lo_portforwardingconfig = lo_launchconfig->get_portforwardingconfig( ).
IF lo_portforwardingconfig IS NOT INITIAL.
LOOP AT lo_portforwardingconfig->get_portmappings( ) into lo_row_3.
lo_row_4 = lo_row_3.
IF lo_row_4 IS NOT INITIAL.
lv_port = lo_row_4->get_jobport( ).
lv_nonsystemport = lo_row_4->get_applicationport( ).
lv_boolean = lo_row_4->get_enableonpublicip( ).
ENDIF.
ENDLOOP.
ENDIF.
lv_boolean = lo_launchconfig->get_streamui( ).
LOOP AT lo_launchconfig->get_command( ) into lo_row_5.
lo_row_6 = lo_row_5.
IF lo_row_6 IS NOT INITIAL.
lv_nonemptystring = lo_row_6->get_value( ).
ENDIF.
ENDLOOP.
ENDIF.
LOOP AT lo_row_12->get_uploadconfigurations( ) into lo_row_7.
lo_row_8 = lo_row_7.
IF lo_row_8 IS NOT INITIAL.
lv_name = lo_row_8->get_name( ).
lv_path = lo_row_8->get_path( ).
lv_uploadbehavior = lo_row_8->get_uploadbehavior( ).
ENDIF.
ENDLOOP.
LOOP AT lo_row_12->get_worldconfigs( ) into lo_row_13.
lo_row_14 = lo_row_13.
IF lo_row_14 IS NOT INITIAL.
lv_arn = lo_row_14->get_world( ).
ENDIF.
ENDLOOP.
lv_boxedboolean = lo_row_12->get_usedefaultuploadconfs( ).
LOOP AT lo_row_12->get_tools( ) into lo_row_9.
lo_row_10 = lo_row_9.
IF lo_row_10 IS NOT INITIAL.
lv_boxedboolean = lo_row_10->get_streamui( ).
lv_name = lo_row_10->get_name( ).
lv_unrestrictedcommand = lo_row_10->get_command( ).
lv_boxedboolean = lo_row_10->get_streamoutputtocloudwatch( ).
lv_exitbehavior = lo_row_10->get_exitbehavior( ).
ENDIF.
ENDLOOP.
lv_boxedboolean = lo_row_12->get_usedefaulttools( ).
ENDIF.
ENDLOOP.
LOOP AT lo_result->get_datasources( ) into lo_row_15.
lo_row_16 = lo_row_15.
IF lo_row_16 IS NOT INITIAL.
lv_name = lo_row_16->get_name( ).
lv_s3bucket = lo_row_16->get_s3bucket( ).
LOOP AT lo_row_16->get_s3keys( ) into lo_row_17.
lo_row_18 = lo_row_17.
IF lo_row_18 IS NOT INITIAL.
lv_s3keyorprefix = lo_row_18->get_s3key( ).
lv_s3etag = lo_row_18->get_etag( ).
ENDIF.
ENDLOOP.
lv_datasourcetype = lo_row_16->get_type( ).
lv_path = lo_row_16->get_destination( ).
ENDIF.
ENDLOOP.
LOOP AT lo_result->get_tags( ) into ls_row_19.
lv_key_1 = ls_row_19-key.
lo_value_1 = ls_row_19-value.
IF lo_value_1 IS NOT INITIAL.
lv_tagvalue = lo_value_1->get_value( ).
ENDIF.
ENDLOOP.
lo_vpcconfigresponse = lo_result->get_vpcconfig( ).
IF lo_vpcconfigresponse IS NOT INITIAL.
LOOP AT lo_vpcconfigresponse->get_subnets( ) into lo_row_20.
lo_row_21 = lo_row_20.
IF lo_row_21 IS NOT INITIAL.
lv_nonemptystring = lo_row_21->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_vpcconfigresponse->get_securitygroups( ) into lo_row_22.
lo_row_23 = lo_row_22.
IF lo_row_23 IS NOT INITIAL.
lv_nonemptystring = lo_row_23->get_value( ).
ENDIF.
ENDLOOP.
lv_genericstring = lo_vpcconfigresponse->get_vpcid( ).
lv_boolean = lo_vpcconfigresponse->get_assignpublicip( ).
ENDIF.
lo_computeresponse = lo_result->get_compute( ).
IF lo_computeresponse IS NOT INITIAL.
lv_simulationunit = lo_computeresponse->get_simulationunitlimit( ).
lv_computetype = lo_computeresponse->get_computetype( ).
lv_gpuunit = lo_computeresponse->get_gpuunitlimit( ).
ENDIF.
ENDIF.