Skip to content

/AWS1/CL_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

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 maxJobDurationInSeconds is reached, the simulation job will status will transition to Completed.

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 4XX error 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 DataSourceConfig objects.

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