AWS RoboMaker 2018-06-29
- Client: Aws\RoboMaker\RoboMakerClient
- Service ID: robomaker
- Version: 2018-06-29
This page describes the parameters and results for the operations of the AWS RoboMaker (2018-06-29), and shows how to use the Aws\RoboMaker\RoboMakerClient object to call the described operations. This documentation is specific to the 2018-06-29 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName')
, where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */)
.
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
- BatchDeleteWorlds ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- BatchDescribeSimulationJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CancelDeploymentJob ( array $params = [] )
- This API is no longer supported.
- CancelSimulationJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CancelSimulationJobBatch ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CancelWorldExportJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CancelWorldGenerationJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateDeploymentJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateFleet ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateRobot ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateRobotApplication ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateRobotApplicationVersion ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateSimulationApplication ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateSimulationApplicationVersion ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateSimulationJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateWorldExportJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateWorldGenerationJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- CreateWorldTemplate ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DeleteFleet ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DeleteRobot ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DeleteRobotApplication ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DeleteSimulationApplication ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DeleteWorldTemplate ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DeregisterRobot ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeDeploymentJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeFleet ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeRobot ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeRobotApplication ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeSimulationApplication ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeSimulationJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeSimulationJobBatch ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeWorld ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeWorldExportJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeWorldGenerationJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- DescribeWorldTemplate ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- GetWorldTemplateBody ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListDeploymentJobs ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListFleets ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListRobotApplications ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListRobots ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListSimulationApplications ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListSimulationJobBatches ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListSimulationJobs ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListTagsForResource ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListWorldExportJobs ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListWorldGenerationJobs ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListWorldTemplates ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- ListWorlds ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- RegisterRobot ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- RestartSimulationJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- StartSimulationJobBatch ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- SyncDeploymentJob ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- TagResource ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- UntagResource ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- UpdateRobotApplication ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- UpdateSimulationApplication ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
- UpdateWorldTemplate ( array $params = [] )
- End of support notice: On September 10, 2025, Amazon Web Services will discontinue support for Amazon Web Services RoboMaker.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
- ListDeploymentJobs
- ListFleets
- ListRobotApplications
- ListRobots
- ListSimulationApplications
- ListSimulationJobBatches
- ListSimulationJobs
- ListWorldExportJobs
- ListWorldGenerationJobs
- ListWorldTemplates
- ListWorlds
Operations
BatchDeleteWorlds
$result = $client->batchDeleteWorlds
([/* ... */]); $promise = $client->batchDeleteWorldsAsync
([/* ... */]);
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/.
Deletes one or more worlds in a batch operation.
Parameter Syntax
$result = $client->batchDeleteWorlds([ 'worlds' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- worlds
-
- Required: Yes
- Type: Array of strings
A list of Amazon Resource Names (arns) that correspond to worlds to delete.
Result Syntax
[ 'unprocessedWorlds' => ['<string>', ...], ]
Result Details
Members
- unprocessedWorlds
-
- Type: Array of strings
A list of unprocessed worlds associated with the call. These worlds were not deleted.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
BatchDescribeSimulationJob
$result = $client->batchDescribeSimulationJob
([/* ... */]); $promise = $client->batchDescribeSimulationJobAsync
([/* ... */]);
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/.
Describes one or more simulation jobs.
Parameter Syntax
$result = $client->batchDescribeSimulationJob([ 'jobs' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- jobs
-
- Required: Yes
- Type: Array of strings
A list of Amazon Resource Names (ARNs) of simulation jobs to describe.
Result Syntax
[ 'jobs' => [ [ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', 's3Bucket' => '<string>', 's3Keys' => [ [ 'etag' => '<string>', 's3Key' => '<string>', ], // ... ], 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'failureCode' => 'InternalServiceError|RobotApplicationCrash|SimulationApplicationCrash|RobotApplicationHealthCheckFailure|SimulationApplicationHealthCheckFailure|BadPermissionsRobotApplication|BadPermissionsSimulationApplication|BadPermissionsS3Object|BadPermissionsS3Output|BadPermissionsCloudwatchLogs|SubnetIpLimitExceeded|ENILimitExceeded|BadPermissionsUserCredentials|InvalidBundleRobotApplication|InvalidBundleSimulationApplication|InvalidS3Resource|ThrottlingError|LimitExceeded|MismatchedEtag|RobotApplicationVersionMismatchedEtag|SimulationApplicationVersionMismatchedEtag|ResourceNotFound|RequestThrottled|BatchTimedOut|BatchCanceled|InvalidInput|WrongRegionS3Bucket|WrongRegionS3Output|WrongRegionRobotApplication|WrongRegionSimulationApplication|UploadContentMismatchError', 'failureReason' => '<string>', 'iamRole' => '<string>', 'lastStartedAt' => <DateTime>, 'lastUpdatedAt' => <DateTime>, 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, 'name' => '<string>', 'networkInterface' => [ 'networkInterfaceId' => '<string>', 'privateIpAddress' => '<string>', 'publicIpAddress' => '<string>', ], 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'simulationTimeMillis' => <integer>, 'status' => 'Pending|Preparing|Running|Restarting|Completed|Failed|RunningFailed|Terminating|Terminated|Canceled', 'tags' => ['<string>', ...], 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], 'vpcId' => '<string>', ], ], // ... ], 'unprocessedJobs' => ['<string>', ...], ]
Result Details
Members
- jobs
-
- Type: Array of SimulationJob structures
A list of simulation jobs.
- unprocessedJobs
-
- Type: Array of strings
A list of unprocessed simulation job Amazon Resource Names (ARNs).
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
CancelDeploymentJob
$result = $client->cancelDeploymentJob
([/* ... */]); $promise = $client->cancelDeploymentJobAsync
([/* ... */]);
This API is no longer supported. For more information, see the May 2, 2022 update in the Support policy page.
Cancels the specified deployment job.
Parameter Syntax
$result = $client->cancelDeploymentJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The deployment job ARN to cancel.
Result Syntax
[]
Result Details
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
CancelSimulationJob
$result = $client->cancelSimulationJob
([/* ... */]); $promise = $client->cancelSimulationJobAsync
([/* ... */]);
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/.
Cancels the specified simulation job.
Parameter Syntax
$result = $client->cancelSimulationJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The simulation job ARN to cancel.
Result Syntax
[]
Result Details
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
CancelSimulationJobBatch
$result = $client->cancelSimulationJobBatch
([/* ... */]); $promise = $client->cancelSimulationJobBatchAsync
([/* ... */]);
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/.
Cancels a simulation job batch. When you cancel a simulation job batch, you are also cancelling all of the active simulation jobs created as part of the batch.
Parameter Syntax
$result = $client->cancelSimulationJobBatch([ 'batch' => '<string>', // REQUIRED ]);
Parameter Details
Members
- batch
-
- Required: Yes
- Type: string
The id of the batch to cancel.
Result Syntax
[]
Result Details
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
CancelWorldExportJob
$result = $client->cancelWorldExportJob
([/* ... */]); $promise = $client->cancelWorldExportJobAsync
([/* ... */]);
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/.
Cancels the specified export job.
Parameter Syntax
$result = $client->cancelWorldExportJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world export job to cancel.
Result Syntax
[]
Result Details
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
CancelWorldGenerationJob
$result = $client->cancelWorldGenerationJob
([/* ... */]); $promise = $client->cancelWorldGenerationJobAsync
([/* ... */]);
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/.
Cancels the specified world generator job.
Parameter Syntax
$result = $client->cancelWorldGenerationJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world generator job to cancel.
Result Syntax
[]
Result Details
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
CreateDeploymentJob
$result = $client->createDeploymentJob
([/* ... */]); $promise = $client->createDeploymentJobAsync
([/* ... */]);
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.
Parameter Syntax
$result = $client->createDeploymentJob([ 'clientRequestToken' => '<string>', // REQUIRED 'deploymentApplicationConfigs' => [ // REQUIRED [ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', // REQUIRED 'launchConfig' => [ // REQUIRED 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', // REQUIRED 'packageName' => '<string>', // REQUIRED 'postLaunchFile' => '<string>', 'preLaunchFile' => '<string>', ], ], // ... ], 'deploymentConfig' => [ 'concurrentDeploymentPercentage' => <integer>, 'downloadConditionFile' => [ 'bucket' => '<string>', // REQUIRED 'etag' => '<string>', 'key' => '<string>', // REQUIRED ], 'failureThresholdPercentage' => <integer>, 'robotDeploymentTimeoutInSeconds' => <integer>, ], 'fleet' => '<string>', // REQUIRED 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- clientRequestToken
-
- Required: Yes
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- deploymentApplicationConfigs
-
- Required: Yes
- Type: Array of DeploymentApplicationConfig structures
The deployment application configuration.
- deploymentConfig
-
- Type: DeploymentConfig structure
The requested deployment configuration.
- fleet
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the fleet to deploy.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the deployment job.
Result Syntax
[ 'arn' => '<string>', 'createdAt' => <DateTime>, 'deploymentApplicationConfigs' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'postLaunchFile' => '<string>', 'preLaunchFile' => '<string>', ], ], // ... ], 'deploymentConfig' => [ 'concurrentDeploymentPercentage' => <integer>, 'downloadConditionFile' => [ 'bucket' => '<string>', 'etag' => '<string>', 'key' => '<string>', ], 'failureThresholdPercentage' => <integer>, 'robotDeploymentTimeoutInSeconds' => <integer>, ], 'failureCode' => 'ResourceNotFound|EnvironmentSetupError|EtagMismatch|FailureThresholdBreached|RobotDeploymentAborted|RobotDeploymentNoResponse|RobotAgentConnectionTimeout|GreengrassDeploymentFailed|InvalidGreengrassGroup|MissingRobotArchitecture|MissingRobotApplicationArchitecture|MissingRobotDeploymentResource|GreengrassGroupVersionDoesNotExist|LambdaDeleted|ExtractingBundleFailure|PreLaunchFileFailure|PostLaunchFileFailure|BadPermissionError|DownloadConditionFailed|BadLambdaAssociated|InternalServerError|RobotApplicationDoesNotExist|DeploymentFleetDoesNotExist|FleetDeploymentTimeout', 'failureReason' => '<string>', 'fleet' => '<string>', 'status' => 'Pending|Preparing|InProgress|Failed|Succeeded|Canceled', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the deployment job.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the fleet was created.
- deploymentApplicationConfigs
-
- Type: Array of DeploymentApplicationConfig structures
The deployment application configuration.
- deploymentConfig
-
- Type: DeploymentConfig structure
The deployment configuration.
- failureCode
-
- Type: string
The failure code of the simulation job if it failed:
- BadPermissionError
-
AWS Greengrass requires a service-level role permission to access other services. The role must include the
AWSGreengrassResourceAccessRolePolicy
managed policy. - ExtractingBundleFailure
-
The robot application could not be extracted from the bundle.
- FailureThresholdBreached
-
The percentage of robots that could not be updated exceeded the percentage set for the deployment.
- GreengrassDeploymentFailed
-
The robot application could not be deployed to the robot.
- GreengrassGroupVersionDoesNotExist
-
The AWS Greengrass group or version associated with a robot is missing.
- InternalServerError
-
An internal error has occurred. Retry your request, but if the problem persists, contact us with details.
- MissingRobotApplicationArchitecture
-
The robot application does not have a source that matches the architecture of the robot.
- MissingRobotDeploymentResource
-
One or more of the resources specified for the robot application are missing. For example, does the robot application have the correct launch package and launch file?
- PostLaunchFileFailure
-
The post-launch script failed.
- PreLaunchFileFailure
-
The pre-launch script failed.
- ResourceNotFound
-
One or more deployment resources are missing. For example, do robot application source bundles still exist?
- RobotDeploymentNoResponse
-
There is no response from the robot. It might not be powered on or connected to the internet.
- failureReason
-
- Type: string
The failure reason of the deployment job if it failed.
- fleet
-
- Type: string
The target fleet for the deployment job.
- status
-
- Type: string
The status of the deployment job.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the deployment job.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ConcurrentDeploymentException:
The failure percentage threshold percentage was met.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
CreateFleet
$result = $client->createFleet
([/* ... */]); $promise = $client->createFleetAsync
([/* ... */]);
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.
Creates a fleet, a logical group of robots running the same robot application.
Parameter Syntax
$result = $client->createFleet([ 'name' => '<string>', // REQUIRED 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- name
-
- Required: Yes
- Type: string
The name of the fleet.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the fleet.
Result Syntax
[ 'arn' => '<string>', 'createdAt' => <DateTime>, 'name' => '<string>', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the fleet was created.
- name
-
- Type: string
The name of the fleet.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the fleet.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
CreateRobot
$result = $client->createRobot
([/* ... */]); $promise = $client->createRobotAsync
([/* ... */]);
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.
Creates a robot.
Parameter Syntax
$result = $client->createRobot([ 'architecture' => 'X86_64|ARM64|ARMHF', // REQUIRED 'greengrassGroupId' => '<string>', // REQUIRED 'name' => '<string>', // REQUIRED 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- architecture
-
- Required: Yes
- Type: string
The target architecture of the robot.
- greengrassGroupId
-
- Required: Yes
- Type: string
The Greengrass group id.
- name
-
- Required: Yes
- Type: string
The name for the robot.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the robot.
Result Syntax
[ 'architecture' => 'X86_64|ARM64|ARMHF', 'arn' => '<string>', 'createdAt' => <DateTime>, 'greengrassGroupId' => '<string>', 'name' => '<string>', 'tags' => ['<string>', ...], ]
Result Details
Members
- architecture
-
- Type: string
The target architecture of the robot.
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the robot.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the robot was created.
- greengrassGroupId
-
- Type: string
The Amazon Resource Name (ARN) of the Greengrass group associated with the robot.
- name
-
- Type: string
The name of the robot.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the robot.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ResourceAlreadyExistsException:
The specified resource already exists.
CreateRobotApplication
$result = $client->createRobotApplication
([/* ... */]); $promise = $client->createRobotApplicationAsync
([/* ... */]);
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 robot application.
Parameter Syntax
$result = $client->createRobotApplication([ 'environment' => [ 'uri' => '<string>', ], 'name' => '<string>', // REQUIRED 'robotSoftwareSuite' => [ // REQUIRED 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- environment
-
- Type: Environment structure
The object that contains that URI of the Docker image that you use for your robot application.
- name
-
- Required: Yes
- Type: string
The name of the robot application.
- robotSoftwareSuite
-
- Required: Yes
- Type: RobotSoftwareSuite structure
The robot software suite used by the robot application.
- sources
-
- Type: Array of SourceConfig structures
The sources of the robot application.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the robot application.
Result Syntax
[ 'arn' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'revisionId' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'etag' => '<string>', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the robot application.
- environment
-
- Type: Environment structure
An object that contains the Docker image URI used to a create your robot application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the robot application was last updated.
- name
-
- Type: string
The name of the robot application.
- revisionId
-
- Type: string
The revision id of the robot application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
The robot software suite used by the robot application.
- sources
-
- Type: Array of Source structures
The sources of the robot application.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the robot application.
- version
-
- Type: string
The version of the robot application.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceAlreadyExistsException:
The specified resource already exists.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
CreateRobotApplicationVersion
$result = $client->createRobotApplicationVersion
([/* ... */]); $promise = $client->createRobotApplicationVersionAsync
([/* ... */]);
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 version of a robot application.
Parameter Syntax
$result = $client->createRobotApplicationVersion([ 'application' => '<string>', // REQUIRED 'currentRevisionId' => '<string>', 'imageDigest' => '<string>', 's3Etags' => ['<string>', ...], ]);
Parameter Details
Members
- application
-
- Required: Yes
- Type: string
The application information for the robot application.
- currentRevisionId
-
- Type: string
The current revision id for the robot application. If you provide a value and it matches the latest revision ID, a new version will be created.
- imageDigest
-
- Type: string
A SHA256 identifier for the Docker image that you use for your robot application.
- s3Etags
-
- Type: Array of strings
The Amazon S3 identifier for the zip file bundle that you use for your robot application.
Result Syntax
[ 'arn' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'revisionId' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'etag' => '<string>', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the robot application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI used to create your robot application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the robot application was last updated.
- name
-
- Type: string
The name of the robot application.
- revisionId
-
- Type: string
The revision id of the robot application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
The robot software suite used by the robot application.
- sources
-
- Type: Array of Source structures
The sources of the robot application.
- version
-
- Type: string
The version of the robot application.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
CreateSimulationApplication
$result = $client->createSimulationApplication
([/* ... */]); $promise = $client->createSimulationApplicationAsync
([/* ... */]);
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 application.
Parameter Syntax
$result = $client->createSimulationApplication([ 'environment' => [ 'uri' => '<string>', ], 'name' => '<string>', // REQUIRED 'renderingEngine' => [ 'name' => 'OGRE', 'version' => '<string>', ], 'robotSoftwareSuite' => [ // REQUIRED 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'simulationSoftwareSuite' => [ // REQUIRED 'name' => 'Gazebo|RosbagPlay|SimulationRuntime', 'version' => '<string>', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- environment
-
- Type: Environment structure
The object that contains the Docker image URI used to create your simulation application.
- name
-
- Required: Yes
- Type: string
The name of the simulation application.
- renderingEngine
-
- Type: RenderingEngine structure
The rendering engine for the simulation application.
- robotSoftwareSuite
-
- Required: Yes
- Type: RobotSoftwareSuite structure
The robot software suite used by the simulation application.
- simulationSoftwareSuite
-
- Required: Yes
- Type: SimulationSoftwareSuite structure
The simulation software suite used by the simulation application.
- sources
-
- Type: Array of SourceConfig structures
The sources of the simulation application.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the simulation application.
Result Syntax
[ 'arn' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'renderingEngine' => [ 'name' => 'OGRE', 'version' => '<string>', ], 'revisionId' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'simulationSoftwareSuite' => [ 'name' => 'Gazebo|RosbagPlay|SimulationRuntime', 'version' => '<string>', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'etag' => '<string>', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the simulation application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI that you used to create your simulation application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation application was last updated.
- name
-
- Type: string
The name of the simulation application.
- renderingEngine
-
- Type: RenderingEngine structure
The rendering engine for the simulation application.
- revisionId
-
- Type: string
The revision id of the simulation application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
Information about the robot software suite.
- simulationSoftwareSuite
-
- Type: SimulationSoftwareSuite structure
The simulation software suite used by the simulation application.
- sources
-
- Type: Array of Source structures
The sources of the simulation application.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the simulation application.
- version
-
- Type: string
The version of the simulation application.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceAlreadyExistsException:
The specified resource already exists.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
CreateSimulationApplicationVersion
$result = $client->createSimulationApplicationVersion
([/* ... */]); $promise = $client->createSimulationApplicationVersionAsync
([/* ... */]);
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 application with a specific revision id.
Parameter Syntax
$result = $client->createSimulationApplicationVersion([ 'application' => '<string>', // REQUIRED 'currentRevisionId' => '<string>', 'imageDigest' => '<string>', 's3Etags' => ['<string>', ...], ]);
Parameter Details
Members
- application
-
- Required: Yes
- Type: string
The application information for the simulation application.
- currentRevisionId
-
- Type: string
The current revision id for the simulation application. If you provide a value and it matches the latest revision ID, a new version will be created.
- imageDigest
-
- Type: string
The SHA256 digest used to identify the Docker image URI used to created the simulation application.
- s3Etags
-
- Type: Array of strings
The Amazon S3 eTag identifier for the zip file bundle that you use to create the simulation application.
Result Syntax
[ 'arn' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'renderingEngine' => [ 'name' => 'OGRE', 'version' => '<string>', ], 'revisionId' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'simulationSoftwareSuite' => [ 'name' => 'Gazebo|RosbagPlay|SimulationRuntime', 'version' => '<string>', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'etag' => '<string>', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the simulation application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI used to create the simulation application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation application was last updated.
- name
-
- Type: string
The name of the simulation application.
- renderingEngine
-
- Type: RenderingEngine structure
The rendering engine for the simulation application.
- revisionId
-
- Type: string
The revision ID of the simulation application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
Information about the robot software suite.
- simulationSoftwareSuite
-
- Type: SimulationSoftwareSuite structure
The simulation software suite used by the simulation application.
- sources
-
- Type: Array of Source structures
The sources of the simulation application.
- version
-
- Type: string
The version of the simulation application.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
CreateSimulationJob
$result = $client->createSimulationJob
([/* ... */]); $promise = $client->createSimulationJobAsync
([/* ... */]);
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.
Parameter Syntax
$result = $client->createSimulationJob([ 'clientRequestToken' => '<string>', 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', // REQUIRED 's3Bucket' => '<string>', // REQUIRED 's3Keys' => ['<string>', ...], // REQUIRED 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'iamRole' => '<string>', // REQUIRED 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, // REQUIRED 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', 'launchConfig' => [ // REQUIRED 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, // REQUIRED 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, // REQUIRED ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', // REQUIRED 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', // REQUIRED 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', // REQUIRED 'path' => '<string>', // REQUIRED 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', // REQUIRED ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', 'launchConfig' => [ // REQUIRED 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, // REQUIRED 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, // REQUIRED ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', // REQUIRED 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', // REQUIRED 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', // REQUIRED 'path' => '<string>', // REQUIRED 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', // REQUIRED ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'tags' => ['<string>', ...], 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], // REQUIRED ], ]);
Parameter Details
Members
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- compute
-
- Type: Compute structure
Compute information for the simulation job.
- dataSources
-
- Type: Array of DataSourceConfig structures
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. - failureBehavior
-
- Type: string
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.
- iamRole
-
- Required: Yes
- Type: string
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.
- loggingConfig
-
- Type: LoggingConfig structure
The logging configuration.
- maxJobDurationInSeconds
-
- Required: Yes
- Type: long (int|float)
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 toCompleted
. - outputLocation
-
- Type: OutputLocation structure
Location for output files generated by the simulation job.
- robotApplications
-
- Type: Array of RobotApplicationConfig structures
The robot application to use in the simulation job.
- simulationApplications
-
- Type: Array of SimulationApplicationConfig structures
The simulation application to use in the simulation job.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the simulation job.
- vpcConfig
-
- Type: VPCConfig structure
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.
Result Syntax
[ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', 's3Bucket' => '<string>', 's3Keys' => [ [ 'etag' => '<string>', 's3Key' => '<string>', ], // ... ], 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'failureCode' => 'InternalServiceError|RobotApplicationCrash|SimulationApplicationCrash|RobotApplicationHealthCheckFailure|SimulationApplicationHealthCheckFailure|BadPermissionsRobotApplication|BadPermissionsSimulationApplication|BadPermissionsS3Object|BadPermissionsS3Output|BadPermissionsCloudwatchLogs|SubnetIpLimitExceeded|ENILimitExceeded|BadPermissionsUserCredentials|InvalidBundleRobotApplication|InvalidBundleSimulationApplication|InvalidS3Resource|ThrottlingError|LimitExceeded|MismatchedEtag|RobotApplicationVersionMismatchedEtag|SimulationApplicationVersionMismatchedEtag|ResourceNotFound|RequestThrottled|BatchTimedOut|BatchCanceled|InvalidInput|WrongRegionS3Bucket|WrongRegionS3Output|WrongRegionRobotApplication|WrongRegionSimulationApplication|UploadContentMismatchError', 'iamRole' => '<string>', 'lastStartedAt' => <DateTime>, 'lastUpdatedAt' => <DateTime>, 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'simulationTimeMillis' => <integer>, 'status' => 'Pending|Preparing|Running|Restarting|Completed|Failed|RunningFailed|Terminating|Terminated|Canceled', 'tags' => ['<string>', ...], 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], 'vpcId' => '<string>', ], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the simulation job.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- compute
-
- Type: ComputeResponse structure
Compute information for the simulation job.
- dataSources
-
- Type: Array of DataSource structures
The data sources for the simulation job.
- failureBehavior
-
- Type: string
the failure behavior for the simulation job.
- failureCode
-
- Type: string
The failure code of the simulation job if it failed:
- InternalServiceError
-
Internal service error.
- RobotApplicationCrash
-
Robot application exited abnormally.
- SimulationApplicationCrash
-
Simulation application exited abnormally.
- BadPermissionsRobotApplication
-
Robot application bundle could not be downloaded.
- BadPermissionsSimulationApplication
-
Simulation application bundle could not be downloaded.
- BadPermissionsS3Output
-
Unable to publish outputs to customer-provided S3 bucket.
- BadPermissionsCloudwatchLogs
-
Unable to publish logs to customer-provided CloudWatch Logs resource.
- SubnetIpLimitExceeded
-
Subnet IP limit exceeded.
- ENILimitExceeded
-
ENI limit exceeded.
- BadPermissionsUserCredentials
-
Unable to use the Role provided.
- InvalidBundleRobotApplication
-
Robot bundle cannot be extracted (invalid format, bundling error, or other issue).
- InvalidBundleSimulationApplication
-
Simulation bundle cannot be extracted (invalid format, bundling error, or other issue).
- RobotApplicationVersionMismatchedEtag
-
Etag for RobotApplication does not match value during version creation.
- SimulationApplicationVersionMismatchedEtag
-
Etag for SimulationApplication does not match value during version creation.
- iamRole
-
- Type: string
The IAM role that allows the simulation job to call the AWS APIs that are specified in its associated policies on your behalf.
- lastStartedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job was last started.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job was last updated.
- loggingConfig
-
- Type: LoggingConfig structure
The logging configuration.
- maxJobDurationInSeconds
-
- Type: long (int|float)
The maximum simulation job duration in seconds.
- outputLocation
-
- Type: OutputLocation structure
Simulation job output files location.
- robotApplications
-
- Type: Array of RobotApplicationConfig structures
The robot application used by the simulation job.
- simulationApplications
-
- Type: Array of SimulationApplicationConfig structures
The simulation application used by the simulation job.
- simulationTimeMillis
-
- Type: long (int|float)
The simulation job execution duration in milliseconds.
- status
-
- Type: string
The status of the simulation job.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the simulation job.
- vpcConfig
-
- Type: VPCConfigResponse structure
Information about the vpc configuration.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
- ServiceUnavailableException:
The request has failed due to a temporary failure of the server.
CreateWorldExportJob
$result = $client->createWorldExportJob
([/* ... */]); $promise = $client->createWorldExportJobAsync
([/* ... */]);
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 world export job.
Parameter Syntax
$result = $client->createWorldExportJob([ 'clientRequestToken' => '<string>', 'iamRole' => '<string>', // REQUIRED 'outputLocation' => [ // REQUIRED 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'tags' => ['<string>', ...], 'worlds' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- iamRole
-
- Required: Yes
- Type: string
The IAM role that the world export process uses to access the Amazon S3 bucket and put the export.
- outputLocation
-
- Required: Yes
- Type: OutputLocation structure
The output location.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world export job.
- worlds
-
- Required: Yes
- Type: Array of strings
A list of Amazon Resource Names (arns) that correspond to worlds to export.
Result Syntax
[ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'createdAt' => <DateTime>, 'failureCode' => 'InternalServiceError|LimitExceeded|ResourceNotFound|RequestThrottled|InvalidInput|AccessDenied', 'iamRole' => '<string>', 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'status' => 'Pending|Running|Completed|Failed|Canceling|Canceled', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world export job.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world export job was created.
- failureCode
-
- Type: string
The failure code of the world export job if it failed:
- InternalServiceError
-
Internal service error.
- LimitExceeded
-
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ResourceNotFound
-
The specified resource could not be found.
- RequestThrottled
-
The request was throttled.
- InvalidInput
-
An input parameter in the request is not valid.
- AllWorldGenerationFailed
-
All of the worlds in the world generation job failed. This can happen if your
worldCount
is greater than 50 or less than 1.
For more information about troubleshooting WorldForge, see Troubleshooting Simulation WorldForge.
- iamRole
-
- Type: string
The IAM role that the world export process uses to access the Amazon S3 bucket and put the export.
- outputLocation
-
- Type: OutputLocation structure
The output location.
- status
-
- Type: string
The status of the world export job.
- Pending
-
The world export job request is pending.
- Running
-
The world export job is running.
- Completed
-
The world export job completed.
- Failed
-
The world export job failed. See
failureCode
for more information. - Canceled
-
The world export job was cancelled.
- Canceling
-
The world export job is being cancelled.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world export job.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
- ServiceUnavailableException:
The request has failed due to a temporary failure of the server.
CreateWorldGenerationJob
$result = $client->createWorldGenerationJob
([/* ... */]); $promise = $client->createWorldGenerationJobAsync
([/* ... */]);
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 worlds using the specified template.
Parameter Syntax
$result = $client->createWorldGenerationJob([ 'clientRequestToken' => '<string>', 'tags' => ['<string>', ...], 'template' => '<string>', // REQUIRED 'worldCount' => [ // REQUIRED 'floorplanCount' => <integer>, 'interiorCountPerFloorplan' => <integer>, ], 'worldTags' => ['<string>', ...], ]);
Parameter Details
Members
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world generator job.
- template
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world template describing the worlds you want to create.
- worldCount
-
- Required: Yes
- Type: WorldCount structure
Information about the world count.
- worldTags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the generated worlds.
Result Syntax
[ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'createdAt' => <DateTime>, 'failureCode' => 'InternalServiceError|LimitExceeded|ResourceNotFound|RequestThrottled|InvalidInput|AllWorldGenerationFailed', 'status' => 'Pending|Running|Completed|Failed|PartialFailed|Canceling|Canceled', 'tags' => ['<string>', ...], 'template' => '<string>', 'worldCount' => [ 'floorplanCount' => <integer>, 'interiorCountPerFloorplan' => <integer>, ], 'worldTags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world generator job.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world generator job was created.
- failureCode
-
- Type: string
The failure code of the world generator job if it failed:
- InternalServiceError
-
Internal service error.
- LimitExceeded
-
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ResourceNotFound
-
The specified resource could not be found.
- RequestThrottled
-
The request was throttled.
- InvalidInput
-
An input parameter in the request is not valid.
- status
-
- Type: string
The status of the world generator job.
- Pending
-
The world generator job request is pending.
- Running
-
The world generator job is running.
- Completed
-
The world generator job completed.
- Failed
-
The world generator job failed. See
failureCode
for more information. - PartialFailed
-
Some worlds did not generate.
- Canceled
-
The world generator job was cancelled.
- Canceling
-
The world generator job is being cancelled.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world generator job.
- template
-
- Type: string
The Amazon Resource Name (arn) of the world template.
- worldCount
-
- Type: WorldCount structure
Information about the world count.
- worldTags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the generated worlds.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
- ServiceUnavailableException:
The request has failed due to a temporary failure of the server.
CreateWorldTemplate
$result = $client->createWorldTemplate
([/* ... */]); $promise = $client->createWorldTemplateAsync
([/* ... */]);
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 world template.
Parameter Syntax
$result = $client->createWorldTemplate([ 'clientRequestToken' => '<string>', 'name' => '<string>', 'tags' => ['<string>', ...], 'templateBody' => '<string>', 'templateLocation' => [ 's3Bucket' => '<string>', // REQUIRED 's3Key' => '<string>', // REQUIRED ], ]);
Parameter Details
Members
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- name
-
- Type: string
The name of the world template.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world template.
- templateBody
-
- Type: string
The world template body.
- templateLocation
-
- Type: TemplateLocation structure
The location of the world template.
Result Syntax
[ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'createdAt' => <DateTime>, 'name' => '<string>', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world template.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world template was created.
- name
-
- Type: string
The name of the world template.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world template.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceAlreadyExistsException:
The specified resource already exists.
- ResourceNotFoundException:
The specified resource does not exist.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
DeleteFleet
$result = $client->deleteFleet
([/* ... */]); $promise = $client->deleteFleetAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Deletes a fleet.
Parameter Syntax
$result = $client->deleteFleet([ 'fleet' => '<string>', // REQUIRED ]);
Parameter Details
Members
- fleet
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the fleet.
Result Syntax
[]
Result Details
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
DeleteRobot
$result = $client->deleteRobot
([/* ... */]); $promise = $client->deleteRobotAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Deletes a robot.
Parameter Syntax
$result = $client->deleteRobot([ 'robot' => '<string>', // REQUIRED ]);
Parameter Details
Members
- robot
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the robot.
Result Syntax
[]
Result Details
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
DeleteRobotApplication
$result = $client->deleteRobotApplication
([/* ... */]); $promise = $client->deleteRobotApplicationAsync
([/* ... */]);
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/.
Deletes a robot application.
Parameter Syntax
$result = $client->deleteRobotApplication([ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', ]);
Parameter Details
Members
- application
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the the robot application.
- applicationVersion
-
- Type: string
The version of the robot application to delete.
Result Syntax
[]
Result Details
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
DeleteSimulationApplication
$result = $client->deleteSimulationApplication
([/* ... */]); $promise = $client->deleteSimulationApplicationAsync
([/* ... */]);
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/.
Deletes a simulation application.
Parameter Syntax
$result = $client->deleteSimulationApplication([ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', ]);
Parameter Details
Members
- application
-
- Required: Yes
- Type: string
The application information for the simulation application to delete.
- applicationVersion
-
- Type: string
The version of the simulation application to delete.
Result Syntax
[]
Result Details
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
DeleteWorldTemplate
$result = $client->deleteWorldTemplate
([/* ... */]); $promise = $client->deleteWorldTemplateAsync
([/* ... */]);
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/.
Deletes a world template.
Parameter Syntax
$result = $client->deleteWorldTemplate([ 'template' => '<string>', // REQUIRED ]);
Parameter Details
Members
- template
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world template you want to delete.
Result Syntax
[]
Result Details
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
DeregisterRobot
$result = $client->deregisterRobot
([/* ... */]); $promise = $client->deregisterRobotAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Deregisters a robot.
Parameter Syntax
$result = $client->deregisterRobot([ 'fleet' => '<string>', // REQUIRED 'robot' => '<string>', // REQUIRED ]);
Parameter Details
Members
- fleet
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- robot
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the robot.
Result Syntax
[ 'fleet' => '<string>', 'robot' => '<string>', ]
Result Details
Members
- fleet
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- robot
-
- Type: string
The Amazon Resource Name (ARN) of the robot.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- ResourceNotFoundException:
The specified resource does not exist.
DescribeDeploymentJob
$result = $client->describeDeploymentJob
([/* ... */]); $promise = $client->describeDeploymentJobAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Describes a deployment job.
Parameter Syntax
$result = $client->describeDeploymentJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the deployment job.
Result Syntax
[ 'arn' => '<string>', 'createdAt' => <DateTime>, 'deploymentApplicationConfigs' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'postLaunchFile' => '<string>', 'preLaunchFile' => '<string>', ], ], // ... ], 'deploymentConfig' => [ 'concurrentDeploymentPercentage' => <integer>, 'downloadConditionFile' => [ 'bucket' => '<string>', 'etag' => '<string>', 'key' => '<string>', ], 'failureThresholdPercentage' => <integer>, 'robotDeploymentTimeoutInSeconds' => <integer>, ], 'failureCode' => 'ResourceNotFound|EnvironmentSetupError|EtagMismatch|FailureThresholdBreached|RobotDeploymentAborted|RobotDeploymentNoResponse|RobotAgentConnectionTimeout|GreengrassDeploymentFailed|InvalidGreengrassGroup|MissingRobotArchitecture|MissingRobotApplicationArchitecture|MissingRobotDeploymentResource|GreengrassGroupVersionDoesNotExist|LambdaDeleted|ExtractingBundleFailure|PreLaunchFileFailure|PostLaunchFileFailure|BadPermissionError|DownloadConditionFailed|BadLambdaAssociated|InternalServerError|RobotApplicationDoesNotExist|DeploymentFleetDoesNotExist|FleetDeploymentTimeout', 'failureReason' => '<string>', 'fleet' => '<string>', 'robotDeploymentSummary' => [ [ 'arn' => '<string>', 'deploymentFinishTime' => <DateTime>, 'deploymentStartTime' => <DateTime>, 'failureCode' => 'ResourceNotFound|EnvironmentSetupError|EtagMismatch|FailureThresholdBreached|RobotDeploymentAborted|RobotDeploymentNoResponse|RobotAgentConnectionTimeout|GreengrassDeploymentFailed|InvalidGreengrassGroup|MissingRobotArchitecture|MissingRobotApplicationArchitecture|MissingRobotDeploymentResource|GreengrassGroupVersionDoesNotExist|LambdaDeleted|ExtractingBundleFailure|PreLaunchFileFailure|PostLaunchFileFailure|BadPermissionError|DownloadConditionFailed|BadLambdaAssociated|InternalServerError|RobotApplicationDoesNotExist|DeploymentFleetDoesNotExist|FleetDeploymentTimeout', 'failureReason' => '<string>', 'progressDetail' => [ 'currentProgress' => 'Validating|DownloadingExtracting|ExecutingDownloadCondition|ExecutingPreLaunch|Launching|ExecutingPostLaunch|Finished', 'estimatedTimeRemainingSeconds' => <integer>, 'percentDone' => <float>, 'targetResource' => '<string>', ], 'status' => 'Available|Registered|PendingNewDeployment|Deploying|Failed|InSync|NoResponse', ], // ... ], 'status' => 'Pending|Preparing|InProgress|Failed|Succeeded|Canceled', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the deployment job.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the deployment job was created.
- deploymentApplicationConfigs
-
- Type: Array of DeploymentApplicationConfig structures
The deployment application configuration.
- deploymentConfig
-
- Type: DeploymentConfig structure
The deployment configuration.
- failureCode
-
- Type: string
The deployment job failure code.
- failureReason
-
- Type: string
A short description of the reason why the deployment job failed.
- fleet
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- robotDeploymentSummary
-
- Type: Array of RobotDeployment structures
A list of robot deployment summaries.
- status
-
- Type: string
The status of the deployment job.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the specified deployment job.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
DescribeFleet
$result = $client->describeFleet
([/* ... */]); $promise = $client->describeFleetAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Describes a fleet.
Parameter Syntax
$result = $client->describeFleet([ 'fleet' => '<string>', // REQUIRED ]);
Parameter Details
Members
- fleet
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the fleet.
Result Syntax
[ 'arn' => '<string>', 'createdAt' => <DateTime>, 'lastDeploymentJob' => '<string>', 'lastDeploymentStatus' => 'Pending|Preparing|InProgress|Failed|Succeeded|Canceled', 'lastDeploymentTime' => <DateTime>, 'name' => '<string>', 'robots' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'arn' => '<string>', 'createdAt' => <DateTime>, 'fleetArn' => '<string>', 'greenGrassGroupId' => '<string>', 'lastDeploymentJob' => '<string>', 'lastDeploymentTime' => <DateTime>, 'name' => '<string>', 'status' => 'Available|Registered|PendingNewDeployment|Deploying|Failed|InSync|NoResponse', ], // ... ], 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the fleet was created.
- lastDeploymentJob
-
- Type: string
The Amazon Resource Name (ARN) of the last deployment job.
- lastDeploymentStatus
-
- Type: string
The status of the last deployment.
- lastDeploymentTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time of the last deployment.
- name
-
- Type: string
The name of the fleet.
- robots
-
- Type: Array of Robot structures
A list of robots.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the specified fleet.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
DescribeRobot
$result = $client->describeRobot
([/* ... */]); $promise = $client->describeRobotAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Describes a robot.
Parameter Syntax
$result = $client->describeRobot([ 'robot' => '<string>', // REQUIRED ]);
Parameter Details
Members
- robot
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the robot to be described.
Result Syntax
[ 'architecture' => 'X86_64|ARM64|ARMHF', 'arn' => '<string>', 'createdAt' => <DateTime>, 'fleetArn' => '<string>', 'greengrassGroupId' => '<string>', 'lastDeploymentJob' => '<string>', 'lastDeploymentTime' => <DateTime>, 'name' => '<string>', 'status' => 'Available|Registered|PendingNewDeployment|Deploying|Failed|InSync|NoResponse', 'tags' => ['<string>', ...], ]
Result Details
Members
- architecture
-
- Type: string
The target architecture of the robot application.
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the robot.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the robot was created.
- fleetArn
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- greengrassGroupId
-
- Type: string
The Greengrass group id.
- lastDeploymentJob
-
- Type: string
The Amazon Resource Name (ARN) of the last deployment job.
- lastDeploymentTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time of the last deployment job.
- name
-
- Type: string
The name of the robot.
- status
-
- Type: string
The status of the fleet.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the specified robot.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
DescribeRobotApplication
$result = $client->describeRobotApplication
([/* ... */]); $promise = $client->describeRobotApplicationAsync
([/* ... */]);
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/.
Describes a robot application.
Parameter Syntax
$result = $client->describeRobotApplication([ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', ]);
Parameter Details
Members
- application
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the robot application.
- applicationVersion
-
- Type: string
The version of the robot application to describe.
Result Syntax
[ 'arn' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'imageDigest' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'revisionId' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'etag' => '<string>', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the robot application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI used to create the robot application.
- imageDigest
-
- Type: string
A SHA256 identifier for the Docker image that you use for your robot application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the robot application was last updated.
- name
-
- Type: string
The name of the robot application.
- revisionId
-
- Type: string
The revision id of the robot application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
The robot software suite used by the robot application.
- sources
-
- Type: Array of Source structures
The sources of the robot application.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the specified robot application.
- version
-
- Type: string
The version of the robot application.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
DescribeSimulationApplication
$result = $client->describeSimulationApplication
([/* ... */]); $promise = $client->describeSimulationApplicationAsync
([/* ... */]);
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/.
Describes a simulation application.
Parameter Syntax
$result = $client->describeSimulationApplication([ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', ]);
Parameter Details
Members
- application
-
- Required: Yes
- Type: string
The application information for the simulation application.
- applicationVersion
-
- Type: string
The version of the simulation application to describe.
Result Syntax
[ 'arn' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'imageDigest' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'renderingEngine' => [ 'name' => 'OGRE', 'version' => '<string>', ], 'revisionId' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'simulationSoftwareSuite' => [ 'name' => 'Gazebo|RosbagPlay|SimulationRuntime', 'version' => '<string>', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'etag' => '<string>', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'tags' => ['<string>', ...], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the robot simulation application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI used to create the simulation application.
- imageDigest
-
- Type: string
A SHA256 identifier for the Docker image that you use for your simulation application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation application was last updated.
- name
-
- Type: string
The name of the simulation application.
- renderingEngine
-
- Type: RenderingEngine structure
The rendering engine for the simulation application.
- revisionId
-
- Type: string
The revision id of the simulation application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
Information about the robot software suite.
- simulationSoftwareSuite
-
- Type: SimulationSoftwareSuite structure
The simulation software suite used by the simulation application.
- sources
-
- Type: Array of Source structures
The sources of the simulation application.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the specified simulation application.
- version
-
- Type: string
The version of the simulation application.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
DescribeSimulationJob
$result = $client->describeSimulationJob
([/* ... */]); $promise = $client->describeSimulationJobAsync
([/* ... */]);
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/.
Describes a simulation job.
Parameter Syntax
$result = $client->describeSimulationJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the simulation job to be described.
Result Syntax
[ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', 's3Bucket' => '<string>', 's3Keys' => [ [ 'etag' => '<string>', 's3Key' => '<string>', ], // ... ], 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'failureCode' => 'InternalServiceError|RobotApplicationCrash|SimulationApplicationCrash|RobotApplicationHealthCheckFailure|SimulationApplicationHealthCheckFailure|BadPermissionsRobotApplication|BadPermissionsSimulationApplication|BadPermissionsS3Object|BadPermissionsS3Output|BadPermissionsCloudwatchLogs|SubnetIpLimitExceeded|ENILimitExceeded|BadPermissionsUserCredentials|InvalidBundleRobotApplication|InvalidBundleSimulationApplication|InvalidS3Resource|ThrottlingError|LimitExceeded|MismatchedEtag|RobotApplicationVersionMismatchedEtag|SimulationApplicationVersionMismatchedEtag|ResourceNotFound|RequestThrottled|BatchTimedOut|BatchCanceled|InvalidInput|WrongRegionS3Bucket|WrongRegionS3Output|WrongRegionRobotApplication|WrongRegionSimulationApplication|UploadContentMismatchError', 'failureReason' => '<string>', 'iamRole' => '<string>', 'lastStartedAt' => <DateTime>, 'lastUpdatedAt' => <DateTime>, 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, 'name' => '<string>', 'networkInterface' => [ 'networkInterfaceId' => '<string>', 'privateIpAddress' => '<string>', 'publicIpAddress' => '<string>', ], 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'simulationTimeMillis' => <integer>, 'status' => 'Pending|Preparing|Running|Restarting|Completed|Failed|RunningFailed|Terminating|Terminated|Canceled', 'tags' => ['<string>', ...], 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], 'vpcId' => '<string>', ], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the simulation job.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- compute
-
- Type: ComputeResponse structure
Compute information for the simulation job.
- dataSources
-
- Type: Array of DataSource structures
The data sources for the simulation job.
- failureBehavior
-
- Type: string
The failure behavior for the simulation job.
- failureCode
-
- Type: string
The failure code of the simulation job if it failed:
- InternalServiceError
-
Internal service error.
- RobotApplicationCrash
-
Robot application exited abnormally.
- SimulationApplicationCrash
-
Simulation application exited abnormally.
- BadPermissionsRobotApplication
-
Robot application bundle could not be downloaded.
- BadPermissionsSimulationApplication
-
Simulation application bundle could not be downloaded.
- BadPermissionsS3Output
-
Unable to publish outputs to customer-provided S3 bucket.
- BadPermissionsCloudwatchLogs
-
Unable to publish logs to customer-provided CloudWatch Logs resource.
- SubnetIpLimitExceeded
-
Subnet IP limit exceeded.
- ENILimitExceeded
-
ENI limit exceeded.
- BadPermissionsUserCredentials
-
Unable to use the Role provided.
- InvalidBundleRobotApplication
-
Robot bundle cannot be extracted (invalid format, bundling error, or other issue).
- InvalidBundleSimulationApplication
-
Simulation bundle cannot be extracted (invalid format, bundling error, or other issue).
- RobotApplicationVersionMismatchedEtag
-
Etag for RobotApplication does not match value during version creation.
- SimulationApplicationVersionMismatchedEtag
-
Etag for SimulationApplication does not match value during version creation.
- failureReason
-
- Type: string
Details about why the simulation job failed. For more information about troubleshooting, see Troubleshooting.
- iamRole
-
- Type: string
The IAM role that allows the simulation instance to call the AWS APIs that are specified in its associated policies on your behalf.
- lastStartedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job was last started.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job was last updated.
- loggingConfig
-
- Type: LoggingConfig structure
The logging configuration.
- maxJobDurationInSeconds
-
- Type: long (int|float)
The maximum job duration in seconds. The value must be 8 days (691,200 seconds) or less.
- name
-
- Type: string
The name of the simulation job.
- networkInterface
-
- Type: NetworkInterface structure
The network interface information for the simulation job.
- outputLocation
-
- Type: OutputLocation structure
Location for output files generated by the simulation job.
- robotApplications
-
- Type: Array of RobotApplicationConfig structures
A list of robot applications.
- simulationApplications
-
- Type: Array of SimulationApplicationConfig structures
A list of simulation applications.
- simulationTimeMillis
-
- Type: long (int|float)
The simulation job execution duration in milliseconds.
- status
-
- Type: string
The status of the simulation job.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the specified simulation job.
- vpcConfig
-
- Type: VPCConfigResponse structure
The VPC configuration.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
DescribeSimulationJobBatch
$result = $client->describeSimulationJobBatch
([/* ... */]); $promise = $client->describeSimulationJobBatchAsync
([/* ... */]);
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/.
Describes a simulation job batch.
Parameter Syntax
$result = $client->describeSimulationJobBatch([ 'batch' => '<string>', // REQUIRED ]);
Parameter Details
Members
- batch
-
- Required: Yes
- Type: string
The id of the batch to describe.
Result Syntax
[ 'arn' => '<string>', 'batchPolicy' => [ 'maxConcurrency' => <integer>, 'timeoutInSeconds' => <integer>, ], 'clientRequestToken' => '<string>', 'createdAt' => <DateTime>, 'createdRequests' => [ [ 'arn' => '<string>', 'computeType' => 'CPU|GPU_AND_CPU', 'dataSourceNames' => ['<string>', ...], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'robotApplicationNames' => ['<string>', ...], 'simulationApplicationNames' => ['<string>', ...], 'status' => 'Pending|Preparing|Running|Restarting|Completed|Failed|RunningFailed|Terminating|Terminated|Canceled', ], // ... ], 'failedRequests' => [ [ 'failedAt' => <DateTime>, 'failureCode' => 'InternalServiceError|RobotApplicationCrash|SimulationApplicationCrash|RobotApplicationHealthCheckFailure|SimulationApplicationHealthCheckFailure|BadPermissionsRobotApplication|BadPermissionsSimulationApplication|BadPermissionsS3Object|BadPermissionsS3Output|BadPermissionsCloudwatchLogs|SubnetIpLimitExceeded|ENILimitExceeded|BadPermissionsUserCredentials|InvalidBundleRobotApplication|InvalidBundleSimulationApplication|InvalidS3Resource|ThrottlingError|LimitExceeded|MismatchedEtag|RobotApplicationVersionMismatchedEtag|SimulationApplicationVersionMismatchedEtag|ResourceNotFound|RequestThrottled|BatchTimedOut|BatchCanceled|InvalidInput|WrongRegionS3Bucket|WrongRegionS3Output|WrongRegionRobotApplication|WrongRegionSimulationApplication|UploadContentMismatchError', 'failureReason' => '<string>', 'request' => [ 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', 's3Bucket' => '<string>', 's3Keys' => ['<string>', ...], 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'iamRole' => '<string>', 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'tags' => ['<string>', ...], 'useDefaultApplications' => true || false, 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], ], ], ], // ... ], 'failureCode' => 'InternalServiceError', 'failureReason' => '<string>', 'lastUpdatedAt' => <DateTime>, 'pendingRequests' => [ [ 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', 's3Bucket' => '<string>', 's3Keys' => ['<string>', ...], 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'iamRole' => '<string>', 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'tags' => ['<string>', ...], 'useDefaultApplications' => true || false, 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], ], ], // ... ], 'status' => 'Pending|InProgress|Failed|Completed|Canceled|Canceling|Completing|TimingOut|TimedOut', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the batch.
- batchPolicy
-
- Type: BatchPolicy structure
The batch policy.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job batch was created.
- createdRequests
-
- Type: Array of SimulationJobSummary structures
A list of created simulation job summaries.
- failedRequests
-
- Type: Array of FailedCreateSimulationJobRequest structures
A list of failed create simulation job requests. The request failed to be created into a simulation job. Failed requests do not have a simulation job ID.
- failureCode
-
- Type: string
The failure code of the simulation job batch.
- failureReason
-
- Type: string
The reason the simulation job batch failed.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job batch was last updated.
- pendingRequests
-
- Type: Array of SimulationJobRequest structures
A list of pending simulation job requests. These requests have not yet been created into simulation jobs.
- status
-
- Type: string
The status of the batch.
- Pending
-
The simulation job batch request is pending.
- InProgress
-
The simulation job batch is in progress.
- Failed
-
The simulation job batch failed. One or more simulation job requests could not be completed due to an internal failure (like
InternalServiceError
). SeefailureCode
andfailureReason
for more information. - Completed
-
The simulation batch job completed. A batch is complete when (1) there are no pending simulation job requests in the batch and none of the failed simulation job requests are due to
InternalServiceError
and (2) when all created simulation jobs have reached a terminal state (for example,Completed
orFailed
). - Canceled
-
The simulation batch job was cancelled.
- Canceling
-
The simulation batch job is being cancelled.
- Completing
-
The simulation batch job is completing.
- TimingOut
-
The simulation job batch is timing out.
If a batch timing out, and there are pending requests that were failing due to an internal failure (like
InternalServiceError
), the batch status will beFailed
. If there are no such failing request, the batch status will beTimedOut
. - TimedOut
-
The simulation batch job timed out.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the simulation job batch.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
DescribeWorld
$result = $client->describeWorld
([/* ... */]); $promise = $client->describeWorldAsync
([/* ... */]);
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/.
Describes a world.
Parameter Syntax
$result = $client->describeWorld([ 'world' => '<string>', // REQUIRED ]);
Parameter Details
Members
- world
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world you want to describe.
Result Syntax
[ 'arn' => '<string>', 'createdAt' => <DateTime>, 'generationJob' => '<string>', 'tags' => ['<string>', ...], 'template' => '<string>', 'worldDescriptionBody' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (arn) of the world.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world was created.
- generationJob
-
- Type: string
The Amazon Resource Name (arn) of the world generation job that generated the world.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world.
- template
-
- Type: string
The world template.
- worldDescriptionBody
-
- Type: string
Returns the JSON formatted string that describes the contents of your world.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
DescribeWorldExportJob
$result = $client->describeWorldExportJob
([/* ... */]); $promise = $client->describeWorldExportJobAsync
([/* ... */]);
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/.
Describes a world export job.
Parameter Syntax
$result = $client->describeWorldExportJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world export job to describe.
Result Syntax
[ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'createdAt' => <DateTime>, 'failureCode' => 'InternalServiceError|LimitExceeded|ResourceNotFound|RequestThrottled|InvalidInput|AccessDenied', 'failureReason' => '<string>', 'iamRole' => '<string>', 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'status' => 'Pending|Running|Completed|Failed|Canceling|Canceled', 'tags' => ['<string>', ...], 'worlds' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world export job.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world export job was created.
- failureCode
-
- Type: string
The failure code of the world export job if it failed:
- InternalServiceError
-
Internal service error.
- LimitExceeded
-
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ResourceNotFound
-
The specified resource could not be found.
- RequestThrottled
-
The request was throttled.
- InvalidInput
-
An input parameter in the request is not valid.
- failureReason
-
- Type: string
The reason why the world export job failed.
- iamRole
-
- Type: string
The IAM role that the world export process uses to access the Amazon S3 bucket and put the export.
- outputLocation
-
- Type: OutputLocation structure
The output location.
- status
-
- Type: string
The status of the world export job.
- Pending
-
The world export job request is pending.
- Running
-
The world export job is running.
- Completed
-
The world export job completed.
- Failed
-
The world export job failed. See
failureCode
andfailureReason
for more information. - Canceled
-
The world export job was cancelled.
- Canceling
-
The world export job is being cancelled.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world export job.
- worlds
-
- Type: Array of strings
A list of Amazon Resource Names (arns) that correspond to worlds to be exported.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
DescribeWorldGenerationJob
$result = $client->describeWorldGenerationJob
([/* ... */]); $promise = $client->describeWorldGenerationJobAsync
([/* ... */]);
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/.
Describes a world generation job.
Parameter Syntax
$result = $client->describeWorldGenerationJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world generation job to describe.
Result Syntax
[ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'createdAt' => <DateTime>, 'failureCode' => 'InternalServiceError|LimitExceeded|ResourceNotFound|RequestThrottled|InvalidInput|AllWorldGenerationFailed', 'failureReason' => '<string>', 'finishedWorldsSummary' => [ 'failureSummary' => [ 'failures' => [ [ 'failureCode' => 'InternalServiceError|LimitExceeded|ResourceNotFound|RequestThrottled|InvalidInput|AllWorldGenerationFailed', 'failureCount' => <integer>, 'sampleFailureReason' => '<string>', ], // ... ], 'totalFailureCount' => <integer>, ], 'finishedCount' => <integer>, 'succeededWorlds' => ['<string>', ...], ], 'status' => 'Pending|Running|Completed|Failed|PartialFailed|Canceling|Canceled', 'tags' => ['<string>', ...], 'template' => '<string>', 'worldCount' => [ 'floorplanCount' => <integer>, 'interiorCountPerFloorplan' => <integer>, ], 'worldTags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world generation job.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world generation job was created.
- failureCode
-
- Type: string
The failure code of the world generation job if it failed:
- InternalServiceError
-
Internal service error.
- LimitExceeded
-
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ResourceNotFound
-
The specified resource could not be found.
- RequestThrottled
-
The request was throttled.
- InvalidInput
-
An input parameter in the request is not valid.
- failureReason
-
- Type: string
The reason why the world generation job failed.
- finishedWorldsSummary
-
- Type: FinishedWorldsSummary structure
Summary information about finished worlds.
- status
-
- Type: string
The status of the world generation job:
- Pending
-
The world generation job request is pending.
- Running
-
The world generation job is running.
- Completed
-
The world generation job completed.
- Failed
-
The world generation job failed. See
failureCode
for more information. - PartialFailed
-
Some worlds did not generate.
- Canceled
-
The world generation job was cancelled.
- Canceling
-
The world generation job is being cancelled.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world generation job.
- template
-
- Type: string
The Amazon Resource Name (arn) of the world template.
- worldCount
-
- Type: WorldCount structure
Information about the world count.
- worldTags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the generated worlds.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
DescribeWorldTemplate
$result = $client->describeWorldTemplate
([/* ... */]); $promise = $client->describeWorldTemplateAsync
([/* ... */]);
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/.
Describes a world template.
Parameter Syntax
$result = $client->describeWorldTemplate([ 'template' => '<string>', // REQUIRED ]);
Parameter Details
Members
- template
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world template you want to describe.
Result Syntax
[ 'arn' => '<string>', 'clientRequestToken' => '<string>', 'createdAt' => <DateTime>, 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'tags' => ['<string>', ...], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world template.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world template was created.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world template was last updated.
- name
-
- Type: string
The name of the world template.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the world template.
- version
-
- Type: string
The version of the world template that you're using.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
GetWorldTemplateBody
$result = $client->getWorldTemplateBody
([/* ... */]); $promise = $client->getWorldTemplateBodyAsync
([/* ... */]);
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/.
Gets the world template body.
Parameter Syntax
$result = $client->getWorldTemplateBody([ 'generationJob' => '<string>', 'template' => '<string>', ]);
Parameter Details
Members
- generationJob
-
- Type: string
The Amazon Resource Name (arn) of the world generator job.
- template
-
- Type: string
The Amazon Resource Name (arn) of the world template.
Result Syntax
[ 'templateBody' => '<string>', ]
Result Details
Members
- templateBody
-
- Type: string
The world template body.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
ListDeploymentJobs
$result = $client->listDeploymentJobs
([/* ... */]); $promise = $client->listDeploymentJobsAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Returns a list of deployment jobs for a fleet. You can optionally provide filters to retrieve specific deployment jobs.
Parameter Syntax
$result = $client->listDeploymentJobs([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results.
The filter names
status
andfleetName
are supported. When filtering, you must use the complete value of the filtered item. You can use up to three filters, but they must be for the same named item. For example, if you are looking for items with the statusInProgress
or the statusPending
. - maxResults
-
- Type: int
When this parameter is used,
ListDeploymentJobs
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListDeploymentJobs
request with the returnednextToken
value. This value can be between 1 and 200. If this parameter is not used, thenListDeploymentJobs
returns up to 200 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListDeploymentJobs
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Result Syntax
[ 'deploymentJobs' => [ [ 'arn' => '<string>', 'createdAt' => <DateTime>, 'deploymentApplicationConfigs' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'postLaunchFile' => '<string>', 'preLaunchFile' => '<string>', ], ], // ... ], 'deploymentConfig' => [ 'concurrentDeploymentPercentage' => <integer>, 'downloadConditionFile' => [ 'bucket' => '<string>', 'etag' => '<string>', 'key' => '<string>', ], 'failureThresholdPercentage' => <integer>, 'robotDeploymentTimeoutInSeconds' => <integer>, ], 'failureCode' => 'ResourceNotFound|EnvironmentSetupError|EtagMismatch|FailureThresholdBreached|RobotDeploymentAborted|RobotDeploymentNoResponse|RobotAgentConnectionTimeout|GreengrassDeploymentFailed|InvalidGreengrassGroup|MissingRobotArchitecture|MissingRobotApplicationArchitecture|MissingRobotDeploymentResource|GreengrassGroupVersionDoesNotExist|LambdaDeleted|ExtractingBundleFailure|PreLaunchFileFailure|PostLaunchFileFailure|BadPermissionError|DownloadConditionFailed|BadLambdaAssociated|InternalServerError|RobotApplicationDoesNotExist|DeploymentFleetDoesNotExist|FleetDeploymentTimeout', 'failureReason' => '<string>', 'fleet' => '<string>', 'status' => 'Pending|Preparing|InProgress|Failed|Succeeded|Canceled', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- deploymentJobs
-
- Type: Array of DeploymentJob structures
A list of deployment jobs that meet the criteria of the request.
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListDeploymentJobs
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
ListFleets
$result = $client->listFleets
([/* ... */]); $promise = $client->listFleetsAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Returns a list of fleets. You can optionally provide filters to retrieve specific fleets.
Parameter Syntax
$result = $client->listFleets([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results.
The filter name
name
is supported. When filtering, you must use the complete value of the filtered item. You can use up to three filters. - maxResults
-
- Type: int
When this parameter is used,
ListFleets
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListFleets
request with the returnednextToken
value. This value can be between 1 and 200. If this parameter is not used, thenListFleets
returns up to 200 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListFleets
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.
Result Syntax
[ 'fleetDetails' => [ [ 'arn' => '<string>', 'createdAt' => <DateTime>, 'lastDeploymentJob' => '<string>', 'lastDeploymentStatus' => 'Pending|Preparing|InProgress|Failed|Succeeded|Canceled', 'lastDeploymentTime' => <DateTime>, 'name' => '<string>', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- fleetDetails
-
- Type: Array of Fleet structures
A list of fleet details meeting the request criteria.
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListFleets
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
ListRobotApplications
$result = $client->listRobotApplications
([/* ... */]); $promise = $client->listRobotApplicationsAsync
([/* ... */]);
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/.
Returns a list of robot application. You can optionally provide filters to retrieve specific robot applications.
Parameter Syntax
$result = $client->listRobotApplications([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', 'versionQualifier' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results.
The filter name
name
is supported. When filtering, you must use the complete value of the filtered item. You can use up to three filters. - maxResults
-
- Type: int
When this parameter is used,
ListRobotApplications
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListRobotApplications
request with the returnednextToken
value. This value can be between 1 and 100. If this parameter is not used, thenListRobotApplications
returns up to 100 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListRobotApplications
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - versionQualifier
-
- Type: string
The version qualifier of the robot application.
Result Syntax
[ 'nextToken' => '<string>', 'robotApplicationSummaries' => [ [ 'arn' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'version' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListRobotApplications
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - robotApplicationSummaries
-
- Type: Array of RobotApplicationSummary structures
A list of robot application summaries that meet the criteria of the request.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
ListRobots
$result = $client->listRobots
([/* ... */]); $promise = $client->listRobotsAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Returns a list of robots. You can optionally provide filters to retrieve specific robots.
Parameter Syntax
$result = $client->listRobots([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results.
The filter names
status
andfleetName
are supported. When filtering, you must use the complete value of the filtered item. You can use up to three filters, but they must be for the same named item. For example, if you are looking for items with the statusRegistered
or the statusAvailable
. - maxResults
-
- Type: int
When this parameter is used,
ListRobots
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListRobots
request with the returnednextToken
value. This value can be between 1 and 200. If this parameter is not used, thenListRobots
returns up to 200 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListRobots
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Result Syntax
[ 'nextToken' => '<string>', 'robots' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'arn' => '<string>', 'createdAt' => <DateTime>, 'fleetArn' => '<string>', 'greenGrassGroupId' => '<string>', 'lastDeploymentJob' => '<string>', 'lastDeploymentTime' => <DateTime>, 'name' => '<string>', 'status' => 'Available|Registered|PendingNewDeployment|Deploying|Failed|InSync|NoResponse', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListRobots
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - robots
-
- Type: Array of Robot structures
A list of robots that meet the criteria of the request.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
ListSimulationApplications
$result = $client->listSimulationApplications
([/* ... */]); $promise = $client->listSimulationApplicationsAsync
([/* ... */]);
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/.
Returns a list of simulation applications. You can optionally provide filters to retrieve specific simulation applications.
Parameter Syntax
$result = $client->listSimulationApplications([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', 'versionQualifier' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional list of filters to limit results.
The filter name
name
is supported. When filtering, you must use the complete value of the filtered item. You can use up to three filters. - maxResults
-
- Type: int
When this parameter is used,
ListSimulationApplications
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListSimulationApplications
request with the returnednextToken
value. This value can be between 1 and 100. If this parameter is not used, thenListSimulationApplications
returns up to 100 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListSimulationApplications
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - versionQualifier
-
- Type: string
The version qualifier of the simulation application.
Result Syntax
[ 'nextToken' => '<string>', 'simulationApplicationSummaries' => [ [ 'arn' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'simulationSoftwareSuite' => [ 'name' => 'Gazebo|RosbagPlay|SimulationRuntime', 'version' => '<string>', ], 'version' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListSimulationApplications
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - simulationApplicationSummaries
-
- Type: Array of SimulationApplicationSummary structures
A list of simulation application summaries that meet the criteria of the request.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
ListSimulationJobBatches
$result = $client->listSimulationJobBatches
([/* ... */]); $promise = $client->listSimulationJobBatchesAsync
([/* ... */]);
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/.
Returns a list simulation job batches. You can optionally provide filters to retrieve specific simulation batch jobs.
Parameter Syntax
$result = $client->listSimulationJobBatches([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results.
- maxResults
-
- Type: int
When this parameter is used,
ListSimulationJobBatches
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListSimulationJobBatches
request with the returnednextToken
value. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListSimulationJobBatches
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Result Syntax
[ 'nextToken' => '<string>', 'simulationJobBatchSummaries' => [ [ 'arn' => '<string>', 'createdAt' => <DateTime>, 'createdRequestCount' => <integer>, 'failedRequestCount' => <integer>, 'lastUpdatedAt' => <DateTime>, 'pendingRequestCount' => <integer>, 'status' => 'Pending|InProgress|Failed|Completed|Canceled|Canceling|Completing|TimingOut|TimedOut', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListSimulationJobBatches
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - simulationJobBatchSummaries
-
- Type: Array of SimulationJobBatchSummary structures
A list of simulation job batch summaries.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
ListSimulationJobs
$result = $client->listSimulationJobs
([/* ... */]); $promise = $client->listSimulationJobsAsync
([/* ... */]);
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/.
Returns a list of simulation jobs. You can optionally provide filters to retrieve specific simulation jobs.
Parameter Syntax
$result = $client->listSimulationJobs([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results.
The filter names
status
andsimulationApplicationName
androbotApplicationName
are supported. When filtering, you must use the complete value of the filtered item. You can use up to three filters, but they must be for the same named item. For example, if you are looking for items with the statusPreparing
or the statusRunning
. - maxResults
-
- Type: int
When this parameter is used,
ListSimulationJobs
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListSimulationJobs
request with the returnednextToken
value. This value can be between 1 and 1000. If this parameter is not used, thenListSimulationJobs
returns up to 1000 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListSimulationJobs
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Result Syntax
[ 'nextToken' => '<string>', 'simulationJobSummaries' => [ [ 'arn' => '<string>', 'computeType' => 'CPU|GPU_AND_CPU', 'dataSourceNames' => ['<string>', ...], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'robotApplicationNames' => ['<string>', ...], 'simulationApplicationNames' => ['<string>', ...], 'status' => 'Pending|Preparing|Running|Restarting|Completed|Failed|RunningFailed|Terminating|Terminated|Canceled', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListSimulationJobs
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - simulationJobSummaries
-
- Required: Yes
- Type: Array of SimulationJobSummary structures
A list of simulation job summaries that meet the criteria of the request.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
ListTagsForResource
$result = $client->listTagsForResource
([/* ... */]); $promise = $client->listTagsForResourceAsync
([/* ... */]);
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/.
Lists all tags on a AWS RoboMaker resource.
Parameter Syntax
$result = $client->listTagsForResource([ 'resourceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The AWS RoboMaker Amazon Resource Name (ARN) with tags to be listed.
Result Syntax
[ 'tags' => ['<string>', ...], ]
Result Details
Members
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of all tags added to the specified resource.
Errors
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
ListWorldExportJobs
$result = $client->listWorldExportJobs
([/* ... */]); $promise = $client->listWorldExportJobsAsync
([/* ... */]);
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/.
Lists world export jobs.
Parameter Syntax
$result = $client->listWorldExportJobs([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results. You can use
generationJobId
andtemplateId
. - maxResults
-
- Type: int
When this parameter is used,
ListWorldExportJobs
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListWorldExportJobs
request with the returnednextToken
value. This value can be between 1 and 100. If this parameter is not used, thenListWorldExportJobs
returns up to 100 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListWorldExportJobs
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Result Syntax
[ 'nextToken' => '<string>', 'worldExportJobSummaries' => [ [ 'arn' => '<string>', 'createdAt' => <DateTime>, 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'status' => 'Pending|Running|Completed|Failed|Canceling|Canceled', 'worlds' => ['<string>', ...], ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListWorldExportJobsRequest
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - worldExportJobSummaries
-
- Required: Yes
- Type: Array of WorldExportJobSummary structures
Summary information for world export jobs.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
ListWorldGenerationJobs
$result = $client->listWorldGenerationJobs
([/* ... */]); $promise = $client->listWorldGenerationJobsAsync
([/* ... */]);
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/.
Lists world generator jobs.
Parameter Syntax
$result = $client->listWorldGenerationJobs([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results. You can use
status
andtemplateId
. - maxResults
-
- Type: int
When this parameter is used,
ListWorldGeneratorJobs
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListWorldGeneratorJobs
request with the returnednextToken
value. This value can be between 1 and 100. If this parameter is not used, thenListWorldGeneratorJobs
returns up to 100 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListWorldGenerationJobsRequest
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Result Syntax
[ 'nextToken' => '<string>', 'worldGenerationJobSummaries' => [ [ 'arn' => '<string>', 'createdAt' => <DateTime>, 'failedWorldCount' => <integer>, 'status' => 'Pending|Running|Completed|Failed|PartialFailed|Canceling|Canceled', 'succeededWorldCount' => <integer>, 'template' => '<string>', 'worldCount' => [ 'floorplanCount' => <integer>, 'interiorCountPerFloorplan' => <integer>, ], ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListWorldGeneratorJobsRequest
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - worldGenerationJobSummaries
-
- Required: Yes
- Type: Array of WorldGenerationJobSummary structures
Summary information for world generator jobs.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
ListWorldTemplates
$result = $client->listWorldTemplates
([/* ... */]); $promise = $client->listWorldTemplatesAsync
([/* ... */]);
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/.
Lists world templates.
Parameter Syntax
$result = $client->listWorldTemplates([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
When this parameter is used,
ListWorldTemplates
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListWorldTemplates
request with the returnednextToken
value. This value can be between 1 and 100. If this parameter is not used, thenListWorldTemplates
returns up to 100 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListWorldTemplates
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Result Syntax
[ 'nextToken' => '<string>', 'templateSummaries' => [ [ 'arn' => '<string>', 'createdAt' => <DateTime>, 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'version' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListWorldTemplates
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - templateSummaries
-
- Type: Array of TemplateSummary structures
Summary information for templates.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
ListWorlds
$result = $client->listWorlds
([/* ... */]); $promise = $client->listWorldsAsync
([/* ... */]);
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/.
Lists worlds.
Parameter Syntax
$result = $client->listWorlds([ 'filters' => [ [ 'name' => '<string>', 'values' => ['<string>', ...], ], // ... ], 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- filters
-
- Type: Array of Filter structures
Optional filters to limit results. You can use
status
. - maxResults
-
- Type: int
When this parameter is used,
ListWorlds
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherListWorlds
request with the returnednextToken
value. This value can be between 1 and 100. If this parameter is not used, thenListWorlds
returns up to 100 results and anextToken
value if applicable. - nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListWorlds
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
Result Syntax
[ 'nextToken' => '<string>', 'worldSummaries' => [ [ 'arn' => '<string>', 'createdAt' => <DateTime>, 'generationJob' => '<string>', 'template' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If the previous paginated request did not return all of the remaining results, the response object's
nextToken
parameter value is set to a token. To retrieve the next set of results, callListWorlds
again and assign that token to the request object'snextToken
parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null. - worldSummaries
-
- Type: Array of WorldSummary structures
Summary information for worlds.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
RegisterRobot
$result = $client->registerRobot
([/* ... */]); $promise = $client->registerRobotAsync
([/* ... */]);
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/.
Registers a robot with a fleet.
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.
Parameter Syntax
$result = $client->registerRobot([ 'fleet' => '<string>', // REQUIRED 'robot' => '<string>', // REQUIRED ]);
Parameter Details
Members
- fleet
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- robot
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the robot.
Result Syntax
[ 'fleet' => '<string>', 'robot' => '<string>', ]
Result Details
Members
- fleet
-
- Type: string
The Amazon Resource Name (ARN) of the fleet that the robot will join.
- robot
-
- Type: string
Information about the robot registration.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ResourceNotFoundException:
The specified resource does not exist.
RestartSimulationJob
$result = $client->restartSimulationJob
([/* ... */]); $promise = $client->restartSimulationJobAsync
([/* ... */]);
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/.
Restarts a running simulation job.
Parameter Syntax
$result = $client->restartSimulationJob([ 'job' => '<string>', // REQUIRED ]);
Parameter Details
Members
- job
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the simulation job.
Result Syntax
[]
Result Details
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
StartSimulationJobBatch
$result = $client->startSimulationJobBatch
([/* ... */]); $promise = $client->startSimulationJobBatchAsync
([/* ... */]);
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/.
Starts a new simulation job batch. The batch is defined using one or more SimulationJobRequest
objects.
Parameter Syntax
$result = $client->startSimulationJobBatch([ 'batchPolicy' => [ 'maxConcurrency' => <integer>, 'timeoutInSeconds' => <integer>, ], 'clientRequestToken' => '<string>', 'createSimulationJobRequests' => [ // REQUIRED [ 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', // REQUIRED 's3Bucket' => '<string>', // REQUIRED 's3Keys' => ['<string>', ...], // REQUIRED 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'iamRole' => '<string>', 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, // REQUIRED 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', 'launchConfig' => [ // REQUIRED 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, // REQUIRED 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, // REQUIRED ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', // REQUIRED 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', // REQUIRED 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', // REQUIRED 'path' => '<string>', // REQUIRED 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', // REQUIRED ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', // REQUIRED 'applicationVersion' => '<string>', 'launchConfig' => [ // REQUIRED 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, // REQUIRED 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, // REQUIRED ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', // REQUIRED 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', // REQUIRED 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', // REQUIRED 'path' => '<string>', // REQUIRED 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', // REQUIRED ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'tags' => ['<string>', ...], 'useDefaultApplications' => true || false, 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], // REQUIRED ], ], // ... ], 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- batchPolicy
-
- Type: BatchPolicy structure
The batch policy.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createSimulationJobRequests
-
- Required: Yes
- Type: Array of SimulationJobRequest structures
A list of simulation job requests to create in the batch.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the deployment job batch.
Result Syntax
[ 'arn' => '<string>', 'batchPolicy' => [ 'maxConcurrency' => <integer>, 'timeoutInSeconds' => <integer>, ], 'clientRequestToken' => '<string>', 'createdAt' => <DateTime>, 'createdRequests' => [ [ 'arn' => '<string>', 'computeType' => 'CPU|GPU_AND_CPU', 'dataSourceNames' => ['<string>', ...], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'robotApplicationNames' => ['<string>', ...], 'simulationApplicationNames' => ['<string>', ...], 'status' => 'Pending|Preparing|Running|Restarting|Completed|Failed|RunningFailed|Terminating|Terminated|Canceled', ], // ... ], 'failedRequests' => [ [ 'failedAt' => <DateTime>, 'failureCode' => 'InternalServiceError|RobotApplicationCrash|SimulationApplicationCrash|RobotApplicationHealthCheckFailure|SimulationApplicationHealthCheckFailure|BadPermissionsRobotApplication|BadPermissionsSimulationApplication|BadPermissionsS3Object|BadPermissionsS3Output|BadPermissionsCloudwatchLogs|SubnetIpLimitExceeded|ENILimitExceeded|BadPermissionsUserCredentials|InvalidBundleRobotApplication|InvalidBundleSimulationApplication|InvalidS3Resource|ThrottlingError|LimitExceeded|MismatchedEtag|RobotApplicationVersionMismatchedEtag|SimulationApplicationVersionMismatchedEtag|ResourceNotFound|RequestThrottled|BatchTimedOut|BatchCanceled|InvalidInput|WrongRegionS3Bucket|WrongRegionS3Output|WrongRegionRobotApplication|WrongRegionSimulationApplication|UploadContentMismatchError', 'failureReason' => '<string>', 'request' => [ 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', 's3Bucket' => '<string>', 's3Keys' => ['<string>', ...], 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'iamRole' => '<string>', 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'tags' => ['<string>', ...], 'useDefaultApplications' => true || false, 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], ], ], ], // ... ], 'failureCode' => 'InternalServiceError', 'failureReason' => '<string>', 'pendingRequests' => [ [ 'compute' => [ 'computeType' => 'CPU|GPU_AND_CPU', 'gpuUnitLimit' => <integer>, 'simulationUnitLimit' => <integer>, ], 'dataSources' => [ [ 'destination' => '<string>', 'name' => '<string>', 's3Bucket' => '<string>', 's3Keys' => ['<string>', ...], 'type' => 'Prefix|Archive|File', ], // ... ], 'failureBehavior' => 'Fail|Continue', 'iamRole' => '<string>', 'loggingConfig' => [ 'recordAllRosTopics' => true || false, ], 'maxJobDurationInSeconds' => <integer>, 'outputLocation' => [ 's3Bucket' => '<string>', 's3Prefix' => '<string>', ], 'robotApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, ], // ... ], 'simulationApplications' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'command' => ['<string>', ...], 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'portForwardingConfig' => [ 'portMappings' => [ [ 'applicationPort' => <integer>, 'enableOnPublicIp' => true || false, 'jobPort' => <integer>, ], // ... ], ], 'streamUI' => true || false, ], 'tools' => [ [ 'command' => '<string>', 'exitBehavior' => 'FAIL|RESTART', 'name' => '<string>', 'streamOutputToCloudWatch' => true || false, 'streamUI' => true || false, ], // ... ], 'uploadConfigurations' => [ [ 'name' => '<string>', 'path' => '<string>', 'uploadBehavior' => 'UPLOAD_ON_TERMINATE|UPLOAD_ROLLING_AUTO_REMOVE', ], // ... ], 'useDefaultTools' => true || false, 'useDefaultUploadConfigurations' => true || false, 'worldConfigs' => [ [ 'world' => '<string>', ], // ... ], ], // ... ], 'tags' => ['<string>', ...], 'useDefaultApplications' => true || false, 'vpcConfig' => [ 'assignPublicIp' => true || false, 'securityGroups' => ['<string>', ...], 'subnets' => ['<string>', ...], ], ], // ... ], 'status' => 'Pending|InProgress|Failed|Completed|Canceled|Canceling|Completing|TimingOut|TimedOut', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (arn) of the batch.
- batchPolicy
-
- Type: BatchPolicy structure
The batch policy.
- clientRequestToken
-
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job batch was created.
- createdRequests
-
- Type: Array of SimulationJobSummary structures
A list of created simulation job request summaries.
- failedRequests
-
- Type: Array of FailedCreateSimulationJobRequest structures
A list of failed simulation job requests. The request failed to be created into a simulation job. Failed requests do not have a simulation job ID.
- failureCode
-
- Type: string
The failure code if the simulation job batch failed.
- failureReason
-
- Type: string
The reason the simulation job batch failed.
- pendingRequests
-
- Type: Array of SimulationJobRequest structures
A list of pending simulation job requests. These requests have not yet been created into simulation jobs.
- status
-
- Type: string
The status of the simulation job batch.
- Pending
-
The simulation job batch request is pending.
- InProgress
-
The simulation job batch is in progress.
- Failed
-
The simulation job batch failed. One or more simulation job requests could not be completed due to an internal failure (like
InternalServiceError
). SeefailureCode
andfailureReason
for more information. - Completed
-
The simulation batch job completed. A batch is complete when (1) there are no pending simulation job requests in the batch and none of the failed simulation job requests are due to
InternalServiceError
and (2) when all created simulation jobs have reached a terminal state (for example,Completed
orFailed
). - Canceled
-
The simulation batch job was cancelled.
- Canceling
-
The simulation batch job is being cancelled.
- Completing
-
The simulation batch job is completing.
- TimingOut
-
The simulation job batch is timing out.
If a batch timing out, and there are pending requests that were failing due to an internal failure (like
InternalServiceError
), the batch status will beFailed
. If there are no such failing request, the batch status will beTimedOut
. - TimedOut
-
The simulation batch job timed out.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the deployment job batch.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
SyncDeploymentJob
$result = $client->syncDeploymentJob
([/* ... */]); $promise = $client->syncDeploymentJobAsync
([/* ... */]);
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. For more information, see the May 2, 2022 update in the Support policy page.
Syncrhonizes robots in a fleet to the latest deployment. This is helpful if robots were added after a deployment.
Parameter Syntax
$result = $client->syncDeploymentJob([ 'clientRequestToken' => '<string>', // REQUIRED 'fleet' => '<string>', // REQUIRED ]);
Parameter Details
Members
- clientRequestToken
-
- Required: Yes
- Type: string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- fleet
-
- Required: Yes
- Type: string
The target fleet for the synchronization.
Result Syntax
[ 'arn' => '<string>', 'createdAt' => <DateTime>, 'deploymentApplicationConfigs' => [ [ 'application' => '<string>', 'applicationVersion' => '<string>', 'launchConfig' => [ 'environmentVariables' => ['<string>', ...], 'launchFile' => '<string>', 'packageName' => '<string>', 'postLaunchFile' => '<string>', 'preLaunchFile' => '<string>', ], ], // ... ], 'deploymentConfig' => [ 'concurrentDeploymentPercentage' => <integer>, 'downloadConditionFile' => [ 'bucket' => '<string>', 'etag' => '<string>', 'key' => '<string>', ], 'failureThresholdPercentage' => <integer>, 'robotDeploymentTimeoutInSeconds' => <integer>, ], 'failureCode' => 'ResourceNotFound|EnvironmentSetupError|EtagMismatch|FailureThresholdBreached|RobotDeploymentAborted|RobotDeploymentNoResponse|RobotAgentConnectionTimeout|GreengrassDeploymentFailed|InvalidGreengrassGroup|MissingRobotArchitecture|MissingRobotApplicationArchitecture|MissingRobotDeploymentResource|GreengrassGroupVersionDoesNotExist|LambdaDeleted|ExtractingBundleFailure|PreLaunchFileFailure|PostLaunchFileFailure|BadPermissionError|DownloadConditionFailed|BadLambdaAssociated|InternalServerError|RobotApplicationDoesNotExist|DeploymentFleetDoesNotExist|FleetDeploymentTimeout', 'failureReason' => '<string>', 'fleet' => '<string>', 'status' => 'Pending|Preparing|InProgress|Failed|Succeeded|Canceled', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the synchronization request.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the fleet was created.
- deploymentApplicationConfigs
-
- Type: Array of DeploymentApplicationConfig structures
Information about the deployment application configurations.
- deploymentConfig
-
- Type: DeploymentConfig structure
Information about the deployment configuration.
- failureCode
-
- Type: string
The failure code if the job fails:
- InternalServiceError
-
Internal service error.
- RobotApplicationCrash
-
Robot application exited abnormally.
- SimulationApplicationCrash
-
Simulation application exited abnormally.
- BadPermissionsRobotApplication
-
Robot application bundle could not be downloaded.
- BadPermissionsSimulationApplication
-
Simulation application bundle could not be downloaded.
- BadPermissionsS3Output
-
Unable to publish outputs to customer-provided S3 bucket.
- BadPermissionsCloudwatchLogs
-
Unable to publish logs to customer-provided CloudWatch Logs resource.
- SubnetIpLimitExceeded
-
Subnet IP limit exceeded.
- ENILimitExceeded
-
ENI limit exceeded.
- BadPermissionsUserCredentials
-
Unable to use the Role provided.
- InvalidBundleRobotApplication
-
Robot bundle cannot be extracted (invalid format, bundling error, or other issue).
- InvalidBundleSimulationApplication
-
Simulation bundle cannot be extracted (invalid format, bundling error, or other issue).
- RobotApplicationVersionMismatchedEtag
-
Etag for RobotApplication does not match value during version creation.
- SimulationApplicationVersionMismatchedEtag
-
Etag for SimulationApplication does not match value during version creation.
- failureReason
-
- Type: string
The failure reason if the job fails.
- fleet
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- status
-
- Type: string
The status of the synchronization job.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ConcurrentDeploymentException:
The failure percentage threshold percentage was met.
- IdempotentParameterMismatchException:
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
TagResource
$result = $client->tagResource
([/* ... */]); $promise = $client->tagResourceAsync
([/* ... */]);
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/.
Adds or edits tags for a AWS RoboMaker resource.
Each tag consists of a tag key and a tag value. Tag keys and tag values are both required, but tag values can be empty strings.
For information about the rules that apply to tag keys and tag values, see User-Defined Tag Restrictions in the AWS Billing and Cost Management User Guide.
Parameter Syntax
$result = $client->tagResource([ 'resourceArn' => '<string>', // REQUIRED 'tags' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the AWS RoboMaker resource you are tagging.
- tags
-
- Required: Yes
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the resource.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
UntagResource
$result = $client->untagResource
([/* ... */]); $promise = $client->untagResourceAsync
([/* ... */]);
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/.
Removes the specified tags from the specified AWS RoboMaker resource.
To remove a tag, specify the tag key. To change the tag value of an existing tag key, use TagResource
.
Parameter Syntax
$result = $client->untagResource([ 'resourceArn' => '<string>', // REQUIRED 'tagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the AWS RoboMaker resource you are removing tags.
- tagKeys
-
- Required: Yes
- Type: Array of strings
A map that contains tag keys and tag values that will be unattached from the resource.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
- ResourceNotFoundException:
The specified resource does not exist.
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
UpdateRobotApplication
$result = $client->updateRobotApplication
([/* ... */]); $promise = $client->updateRobotApplicationAsync
([/* ... */]);
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/.
Updates a robot application.
Parameter Syntax
$result = $client->updateRobotApplication([ 'application' => '<string>', // REQUIRED 'currentRevisionId' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'robotSoftwareSuite' => [ // REQUIRED 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], ]);
Parameter Details
Members
- application
-
- Required: Yes
- Type: string
The application information for the robot application.
- currentRevisionId
-
- Type: string
The revision id for the robot application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI for your robot application.
- robotSoftwareSuite
-
- Required: Yes
- Type: RobotSoftwareSuite structure
The robot software suite used by the robot application.
- sources
-
- Type: Array of SourceConfig structures
The sources of the robot application.
Result Syntax
[ 'arn' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'revisionId' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'etag' => '<string>', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the updated robot application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI for your robot application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the robot application was last updated.
- name
-
- Type: string
The name of the robot application.
- revisionId
-
- Type: string
The revision id of the robot application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
The robot software suite used by the robot application.
- sources
-
- Type: Array of Source structures
The sources of the robot application.
- version
-
- Type: string
The version of the robot application.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
UpdateSimulationApplication
$result = $client->updateSimulationApplication
([/* ... */]); $promise = $client->updateSimulationApplicationAsync
([/* ... */]);
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/.
Updates a simulation application.
Parameter Syntax
$result = $client->updateSimulationApplication([ 'application' => '<string>', // REQUIRED 'currentRevisionId' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'renderingEngine' => [ 'name' => 'OGRE', 'version' => '<string>', ], 'robotSoftwareSuite' => [ // REQUIRED 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'simulationSoftwareSuite' => [ // REQUIRED 'name' => 'Gazebo|RosbagPlay|SimulationRuntime', 'version' => '<string>', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], ]);
Parameter Details
Members
- application
-
- Required: Yes
- Type: string
The application information for the simulation application.
- currentRevisionId
-
- Type: string
The revision id for the robot application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI for your simulation application.
- renderingEngine
-
- Type: RenderingEngine structure
The rendering engine for the simulation application.
- robotSoftwareSuite
-
- Required: Yes
- Type: RobotSoftwareSuite structure
Information about the robot software suite.
- simulationSoftwareSuite
-
- Required: Yes
- Type: SimulationSoftwareSuite structure
The simulation software suite used by the simulation application.
- sources
-
- Type: Array of SourceConfig structures
The sources of the simulation application.
Result Syntax
[ 'arn' => '<string>', 'environment' => [ 'uri' => '<string>', ], 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'renderingEngine' => [ 'name' => 'OGRE', 'version' => '<string>', ], 'revisionId' => '<string>', 'robotSoftwareSuite' => [ 'name' => 'ROS|ROS2|General', 'version' => 'Kinetic|Melodic|Dashing|Foxy', ], 'simulationSoftwareSuite' => [ 'name' => 'Gazebo|RosbagPlay|SimulationRuntime', 'version' => '<string>', ], 'sources' => [ [ 'architecture' => 'X86_64|ARM64|ARMHF', 'etag' => '<string>', 's3Bucket' => '<string>', 's3Key' => '<string>', ], // ... ], 'version' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the updated simulation application.
- environment
-
- Type: Environment structure
The object that contains the Docker image URI used for your simulation application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation application was last updated.
- name
-
- Type: string
The name of the simulation application.
- renderingEngine
-
- Type: RenderingEngine structure
The rendering engine for the simulation application.
- revisionId
-
- Type: string
The revision id of the simulation application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
Information about the robot software suite.
- simulationSoftwareSuite
-
- Type: SimulationSoftwareSuite structure
The simulation software suite used by the simulation application.
- sources
-
- Type: Array of Source structures
The sources of the simulation application.
- version
-
- Type: string
The version of the robot application.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- LimitExceededException:
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
UpdateWorldTemplate
$result = $client->updateWorldTemplate
([/* ... */]); $promise = $client->updateWorldTemplateAsync
([/* ... */]);
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/.
Updates a world template.
Parameter Syntax
$result = $client->updateWorldTemplate([ 'name' => '<string>', 'template' => '<string>', // REQUIRED 'templateBody' => '<string>', 'templateLocation' => [ 's3Bucket' => '<string>', // REQUIRED 's3Key' => '<string>', // REQUIRED ], ]);
Parameter Details
Members
- name
-
- Type: string
The name of the template.
- template
-
- Required: Yes
- Type: string
The Amazon Resource Name (arn) of the world template to update.
- templateBody
-
- Type: string
The world template body.
- templateLocation
-
- Type: TemplateLocation structure
The location of the world template.
Result Syntax
[ 'arn' => '<string>', 'createdAt' => <DateTime>, 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', ]
Result Details
Members
- arn
-
- Type: string
The Amazon Resource Name (arn) of the world template.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world template was created.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world template was last updated.
- name
-
- Type: string
The name of the world template.
Errors
- InvalidParameterException:
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
- ResourceNotFoundException:
The specified resource does not exist.
- ThrottlingException:
AWS RoboMaker is temporarily unable to process the request. Try your call again.
- InternalServerException:
AWS RoboMaker experienced a service issue. Try your call again.
Shapes
BatchPolicy
Description
Information about the batch policy.
Members
- maxConcurrency
-
- Type: int
The number of active simulation jobs create as part of the batch that can be in an active state at the same time.
Active states include:
Pending
,Preparing
,Running
,Restarting
,RunningFailed
andTerminating
. All other states are terminal states. - timeoutInSeconds
-
- Type: long (int|float)
The amount of time, in seconds, to wait for the batch to complete.
If a batch times out, and there are pending requests that were failing due to an internal failure (like
InternalServiceError
), they will be moved to the failed list and the batch status will beFailed
. If the pending requests were failing for any other reason, the failed pending requests will be moved to the failed list and the batch status will beTimedOut
.
Compute
Description
Compute information for the simulation job.
Members
- computeType
-
- Type: string
Compute type information for the simulation job.
- gpuUnitLimit
-
- Type: int
Compute GPU unit limit for the simulation job. It is the same as the number of GPUs allocated to the SimulationJob.
- simulationUnitLimit
-
- Type: int
The simulation unit limit. Your simulation is allocated CPU and memory proportional to the supplied simulation unit limit. A simulation unit is 1 vcpu and 2GB of memory. You are only billed for the SU utilization you consume up to the maximum value provided. The default is 15.
ComputeResponse
Description
Compute information for the simulation job
Members
- computeType
-
- Type: string
Compute type response information for the simulation job.
- gpuUnitLimit
-
- Type: int
Compute GPU unit limit for the simulation job. It is the same as the number of GPUs allocated to the SimulationJob.
- simulationUnitLimit
-
- Type: int
The simulation unit limit. Your simulation is allocated CPU and memory proportional to the supplied simulation unit limit. A simulation unit is 1 vcpu and 2GB of memory. You are only billed for the SU utilization you consume up to the maximum value provided. The default is 15.
ConcurrentDeploymentException
Description
The failure percentage threshold percentage was met.
Members
- message
-
- Type: string
DataSource
Description
Information about a data source.
Members
- destination
-
- Type: string
The location where your files are mounted in the container image.
If you've specified the
type
of the data source as anArchive
, you must provide an Amazon S3 object key to your archive. The object key must point to either a.zip
or.tar.gz
file.If you've specified the
type
of the data source as aPrefix
, you provide the Amazon S3 prefix that points to the files that you are using for your data source.If you've specified the
type
of the data source as aFile
, you provide the Amazon S3 path to the file that you're using as your data source. - name
-
- Type: string
The name of the data source.
- s3Bucket
-
- Type: string
The S3 bucket where the data files are located.
- s3Keys
-
- Type: Array of S3KeyOutput structures
The list of S3 keys identifying the data source files.
- type
-
- Type: string
The data type for the data source that you're using for your container image or simulation job. You can use this field to specify whether your data source is an Archive, an Amazon S3 prefix, or a file.
If you don't specify a field, the default value is
File
.
DataSourceConfig
Description
Information about a data source.
Members
- destination
-
- Type: string
The location where your files are mounted in the container image.
If you've specified the
type
of the data source as anArchive
, you must provide an Amazon S3 object key to your archive. The object key must point to either a.zip
or.tar.gz
file.If you've specified the
type
of the data source as aPrefix
, you provide the Amazon S3 prefix that points to the files that you are using for your data source.If you've specified the
type
of the data source as aFile
, you provide the Amazon S3 path to the file that you're using as your data source. - name
-
- Required: Yes
- Type: string
The name of the data source.
- s3Bucket
-
- Required: Yes
- Type: string
The S3 bucket where the data files are located.
- s3Keys
-
- Required: Yes
- Type: Array of strings
The list of S3 keys identifying the data source files.
- type
-
- Type: string
The data type for the data source that you're using for your container image or simulation job. You can use this field to specify whether your data source is an Archive, an Amazon S3 prefix, or a file.
If you don't specify a field, the default value is
File
.
DeploymentApplicationConfig
Description
Information about a deployment application configuration.
Members
- application
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the robot application.
- applicationVersion
-
- Required: Yes
- Type: string
The version of the application.
- launchConfig
-
- Required: Yes
- Type: DeploymentLaunchConfig structure
The launch configuration.
DeploymentConfig
Description
Information about a deployment configuration.
Members
- concurrentDeploymentPercentage
-
- Type: int
The percentage of robots receiving the deployment at the same time.
- downloadConditionFile
-
- Type: S3Object structure
The download condition file.
- failureThresholdPercentage
-
- Type: int
The percentage of deployments that need to fail before stopping deployment.
- robotDeploymentTimeoutInSeconds
-
- Type: long (int|float)
The amount of time, in seconds, to wait for deployment to a single robot to complete. Choose a time between 1 minute and 7 days. The default is 5 hours.
DeploymentJob
Description
Information about a deployment job.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the deployment job.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the deployment job was created.
- deploymentApplicationConfigs
-
- Type: Array of DeploymentApplicationConfig structures
The deployment application configuration.
- deploymentConfig
-
- Type: DeploymentConfig structure
The deployment configuration.
- failureCode
-
- Type: string
The deployment job failure code.
- failureReason
-
- Type: string
A short description of the reason why the deployment job failed.
- fleet
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- status
-
- Type: string
The status of the deployment job.
DeploymentLaunchConfig
Description
Configuration information for a deployment launch.
Members
- environmentVariables
-
- Type: Associative array of custom strings keys (EnvironmentVariableKey) to strings
An array of key/value pairs specifying environment variables for the robot application
- launchFile
-
- Required: Yes
- Type: string
The launch file name.
- packageName
-
- Required: Yes
- Type: string
The package name.
- postLaunchFile
-
- Type: string
The deployment post-launch file. This file will be executed after the launch file.
- preLaunchFile
-
- Type: string
The deployment pre-launch file. This file will be executed prior to the launch file.
Environment
Description
The object that contains the Docker image URI for either your robot or simulation applications.
Members
- uri
-
- Type: string
The Docker image URI for either your robot or simulation applications.
FailedCreateSimulationJobRequest
Description
Information about a failed create simulation job request.
Members
- failedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job batch failed.
- failureCode
-
- Type: string
The failure code.
- failureReason
-
- Type: string
The failure reason of the simulation job request.
- request
-
- Type: SimulationJobRequest structure
The simulation job request.
FailureSummary
Description
Information about worlds that failed.
Members
- failures
-
- Type: Array of WorldFailure structures
The worlds that failed.
- totalFailureCount
-
- Type: int
The total number of failures.
Filter
Description
Information about a filter.
Members
- name
-
- Type: string
The name of the filter.
- values
-
- Type: Array of strings
A list of values.
FinishedWorldsSummary
Description
Information about worlds that finished.
Members
- failureSummary
-
- Type: FailureSummary structure
Information about worlds that failed.
- finishedCount
-
- Type: int
The total number of finished worlds.
- succeededWorlds
-
- Type: Array of strings
A list of worlds that succeeded.
Fleet
Description
Information about a fleet.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the fleet was created.
- lastDeploymentJob
-
- Type: string
The Amazon Resource Name (ARN) of the last deployment job.
- lastDeploymentStatus
-
- Type: string
The status of the last fleet deployment.
- lastDeploymentTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time of the last deployment.
- name
-
- Type: string
The name of the fleet.
IdempotentParameterMismatchException
Description
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
Members
- message
-
- Type: string
InternalServerException
Description
AWS RoboMaker experienced a service issue. Try your call again.
Members
- message
-
- Type: string
InvalidParameterException
Description
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value.
Members
- message
-
- Type: string
LaunchConfig
Description
Information about a launch configuration.
Members
- command
-
- Type: Array of strings
If you've specified
General
as the value for yourRobotSoftwareSuite
, you can use this field to specify a list of commands for your container image.If you've specified
SimulationRuntime
as the value for yourSimulationSoftwareSuite
, you can use this field to specify a list of commands for your container image. - environmentVariables
-
- Type: Associative array of custom strings keys (EnvironmentVariableKey) to strings
The environment variables for the application launch.
- launchFile
-
- Type: string
The launch file name.
- packageName
-
- Type: string
The package name.
- portForwardingConfig
-
- Type: PortForwardingConfig structure
The port forwarding configuration.
- streamUI
-
- Type: boolean
Boolean indicating whether a streaming session will be configured for the application. If
True
, AWS RoboMaker will configure a connection so you can interact with your application as it is running in the simulation. You must configure and launch the component. It must have a graphical user interface.
LimitExceededException
Description
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
Members
- message
-
- Type: string
LoggingConfig
Description
The logging configuration.
Members
- recordAllRosTopics
-
- Type: boolean
A boolean indicating whether to record all ROS topics.
This API is no longer supported and will throw an error if used.
NetworkInterface
Description
Describes a network interface.
Members
- networkInterfaceId
-
- Type: string
The ID of the network interface.
- privateIpAddress
-
- Type: string
The IPv4 address of the network interface within the subnet.
- publicIpAddress
-
- Type: string
The IPv4 public address of the network interface.
OutputLocation
Description
The output location.
Members
- s3Bucket
-
- Type: string
The S3 bucket for output.
- s3Prefix
-
- Type: string
The S3 folder in the
s3Bucket
where output files will be placed.
PortForwardingConfig
Description
Configuration information for port forwarding.
Members
- portMappings
-
- Type: Array of PortMapping structures
The port mappings for the configuration.
PortMapping
Description
An object representing a port mapping.
Members
- applicationPort
-
- Required: Yes
- Type: int
The port number on the application.
- enableOnPublicIp
-
- Type: boolean
A Boolean indicating whether to enable this port mapping on public IP.
- jobPort
-
- Required: Yes
- Type: int
The port number on the simulation job instance to use as a remote connection point.
ProgressDetail
Description
Information about the progress of a deployment job.
Members
- currentProgress
-
- Type: string
The current progress status.
- Validating
-
Validating the deployment.
- DownloadingExtracting
-
Downloading and extracting the bundle on the robot.
- ExecutingPreLaunch
-
Executing pre-launch script(s) if provided.
- Launching
-
Launching the robot application.
- ExecutingPostLaunch
-
Executing post-launch script(s) if provided.
- Finished
-
Deployment is complete.
- estimatedTimeRemainingSeconds
-
- Type: int
Estimated amount of time in seconds remaining in the step. This currently only applies to the
Downloading/Extracting
step of the deployment. It is empty for other steps. - percentDone
-
- Type: float
Precentage of the step that is done. This currently only applies to the
Downloading/Extracting
step of the deployment. It is empty for other steps. - targetResource
-
- Type: string
The Amazon Resource Name (ARN) of the deployment job.
RenderingEngine
Description
Information about a rendering engine.
Members
- name
-
- Type: string
The name of the rendering engine.
- version
-
- Type: string
The version of the rendering engine.
ResourceAlreadyExistsException
Description
The specified resource already exists.
Members
- message
-
- Type: string
ResourceNotFoundException
Description
The specified resource does not exist.
Members
- message
-
- Type: string
Robot
Description
Information about a robot.
Members
- architecture
-
- Type: string
The architecture of the robot.
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the robot.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the robot was created.
- fleetArn
-
- Type: string
The Amazon Resource Name (ARN) of the fleet.
- greenGrassGroupId
-
- Type: string
The Greengrass group associated with the robot.
- lastDeploymentJob
-
- Type: string
The Amazon Resource Name (ARN) of the last deployment job.
- lastDeploymentTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time of the last deployment.
- name
-
- Type: string
The name of the robot.
- status
-
- Type: string
The status of the robot.
RobotApplicationConfig
Description
Application configuration information for a robot.
Members
- application
-
- Required: Yes
- Type: string
The application information for the robot application.
- applicationVersion
-
- Type: string
The version of the robot application.
- launchConfig
-
- Required: Yes
- Type: LaunchConfig structure
The launch configuration for the robot application.
- tools
-
- Type: Array of Tool structures
Information about tools configured for the robot application.
- uploadConfigurations
-
- Type: Array of UploadConfiguration structures
The upload configurations for the robot application.
- useDefaultTools
-
- Type: boolean
A Boolean indicating whether to use default robot application tools. The default tools are rviz, rqt, terminal and rosbag record. The default is
False
.This API is no longer supported and will throw an error if used.
- useDefaultUploadConfigurations
-
- Type: boolean
A Boolean indicating whether to use default upload configurations. By default,
.ros
and.gazebo
files are uploaded when the application terminates and all ROS topics will be recorded.If you set this value, you must specify an
outputLocation
.This API is no longer supported and will throw an error if used.
RobotApplicationSummary
Description
Summary information for a robot application.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the robot.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the robot application was last updated.
- name
-
- Type: string
The name of the robot application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
Information about a robot software suite.
- version
-
- Type: string
The version of the robot application.
RobotDeployment
Description
Information about a robot deployment.
Members
- arn
-
- Type: string
The robot deployment Amazon Resource Name (ARN).
- deploymentFinishTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the deployment finished.
- deploymentStartTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the deployment was started.
- failureCode
-
- Type: string
The robot deployment failure code.
- failureReason
-
- Type: string
A short description of the reason why the robot deployment failed.
- progressDetail
-
- Type: ProgressDetail structure
Information about how the deployment is progressing.
- status
-
- Type: string
The status of the robot deployment.
RobotSoftwareSuite
Description
Information about a robot software suite.
Members
- name
-
- Type: string
The name of the robot software suite.
General
is the only supported value. - version
-
- Type: string
The version of the robot software suite. Not applicable for General software suite.
S3KeyOutput
Description
Information about S3 keys.
Members
- etag
-
- Type: string
The etag for the object.
- s3Key
-
- Type: string
The S3 key.
S3Object
Description
Information about an S3 object.
Members
- bucket
-
- Required: Yes
- Type: string
The bucket containing the object.
- etag
-
- Type: string
The etag of the object.
- key
-
- Required: Yes
- Type: string
The key of the object.
ServiceUnavailableException
Description
The request has failed due to a temporary failure of the server.
Members
- message
-
- Type: string
SimulationApplicationConfig
Description
Information about a simulation application configuration.
Members
- application
-
- Required: Yes
- Type: string
The application information for the simulation application.
- applicationVersion
-
- Type: string
The version of the simulation application.
- launchConfig
-
- Required: Yes
- Type: LaunchConfig structure
The launch configuration for the simulation application.
- tools
-
- Type: Array of Tool structures
Information about tools configured for the simulation application.
- uploadConfigurations
-
- Type: Array of UploadConfiguration structures
Information about upload configurations for the simulation application.
- useDefaultTools
-
- Type: boolean
A Boolean indicating whether to use default simulation application tools. The default tools are rviz, rqt, terminal and rosbag record. The default is
False
.This API is no longer supported and will throw an error if used.
- useDefaultUploadConfigurations
-
- Type: boolean
A Boolean indicating whether to use default upload configurations. By default,
.ros
and.gazebo
files are uploaded when the application terminates and all ROS topics will be recorded.If you set this value, you must specify an
outputLocation
.This API is no longer supported and will throw an error if used.
- worldConfigs
-
- Type: Array of WorldConfig structures
A list of world configurations.
This API is no longer supported and will throw an error if used.
SimulationApplicationSummary
Description
Summary information for a simulation application.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the simulation application.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation application was last updated.
- name
-
- Type: string
The name of the simulation application.
- robotSoftwareSuite
-
- Type: RobotSoftwareSuite structure
Information about a robot software suite.
- simulationSoftwareSuite
-
- Type: SimulationSoftwareSuite structure
Information about a simulation software suite.
- version
-
- Type: string
The version of the simulation application.
SimulationJob
Description
Information about a simulation job.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the simulation job.
- clientRequestToken
-
- Type: string
A unique identifier for this
SimulationJob
request. - compute
-
- Type: ComputeResponse structure
Compute information for the simulation job
- dataSources
-
- Type: Array of DataSource structures
The data sources for the simulation job.
- failureBehavior
-
- Type: string
The failure behavior the simulation job.
- Continue
-
Leaves the host running for its maximum timeout duration after a
4XX
error code. - Fail
-
Stop the simulation job and terminate the instance.
- failureCode
-
- Type: string
The failure code of the simulation job if it failed.
- failureReason
-
- Type: string
The reason why the simulation job failed.
- iamRole
-
- Type: string
The IAM role 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.
- lastStartedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job was last started.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job was last updated.
- loggingConfig
-
- Type: LoggingConfig structure
The logging configuration.
- maxJobDurationInSeconds
-
- Type: long (int|float)
The maximum simulation job duration in seconds. The value must be 8 days (691,200 seconds) or less.
- name
-
- Type: string
The name of the simulation job.
- networkInterface
-
- Type: NetworkInterface structure
Information about a network interface.
- outputLocation
-
- Type: OutputLocation structure
Location for output files generated by the simulation job.
- robotApplications
-
- Type: Array of RobotApplicationConfig structures
A list of robot applications.
- simulationApplications
-
- Type: Array of SimulationApplicationConfig structures
A list of simulation applications.
- simulationTimeMillis
-
- Type: long (int|float)
The simulation job execution duration in milliseconds.
- status
-
- Type: string
Status of the simulation job.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the simulation job.
- vpcConfig
-
- Type: VPCConfigResponse structure
VPC configuration information.
SimulationJobBatchSummary
Description
Information about a simulation job batch.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the batch.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job batch was created.
- createdRequestCount
-
- Type: int
The number of created simulation job requests.
- failedRequestCount
-
- Type: int
The number of failed simulation job requests.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job batch was last updated.
- pendingRequestCount
-
- Type: int
The number of pending simulation job requests.
- status
-
- Type: string
The status of the simulation job batch.
- Pending
-
The simulation job batch request is pending.
- InProgress
-
The simulation job batch is in progress.
- Failed
-
The simulation job batch failed. One or more simulation job requests could not be completed due to an internal failure (like
InternalServiceError
). SeefailureCode
andfailureReason
for more information. - Completed
-
The simulation batch job completed. A batch is complete when (1) there are no pending simulation job requests in the batch and none of the failed simulation job requests are due to
InternalServiceError
and (2) when all created simulation jobs have reached a terminal state (for example,Completed
orFailed
). - Canceled
-
The simulation batch job was cancelled.
- Canceling
-
The simulation batch job is being cancelled.
- Completing
-
The simulation batch job is completing.
- TimingOut
-
The simulation job batch is timing out.
If a batch timing out, and there are pending requests that were failing due to an internal failure (like
InternalServiceError
), the batch status will beFailed
. If there are no such failing request, the batch status will beTimedOut
. - TimedOut
-
The simulation batch job timed out.
SimulationJobRequest
Description
Information about a simulation job request.
Members
- compute
-
- Type: Compute structure
Compute information for the simulation job
- dataSources
-
- Type: Array of DataSourceConfig structures
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. - failureBehavior
-
- Type: string
The failure behavior the simulation job.
- Continue
-
Leaves the host running for its maximum timeout duration after a
4XX
error code. - Fail
-
Stop the simulation job and terminate the instance.
- iamRole
-
- Type: string
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.
- loggingConfig
-
- Type: LoggingConfig structure
The logging configuration.
- maxJobDurationInSeconds
-
- Required: Yes
- Type: long (int|float)
The maximum simulation job duration in seconds. The value must be 8 days (691,200 seconds) or less.
- outputLocation
-
- Type: OutputLocation structure
The output location.
- robotApplications
-
- Type: Array of RobotApplicationConfig structures
The robot applications to use in the simulation job.
- simulationApplications
-
- Type: Array of SimulationApplicationConfig structures
The simulation applications to use in the simulation job.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A map that contains tag keys and tag values that are attached to the simulation job request.
- useDefaultApplications
-
- Type: boolean
A Boolean indicating whether to use default applications in the simulation job. Default applications include Gazebo, rqt, rviz and terminal access.
- vpcConfig
-
- Type: VPCConfig structure
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 two subnet IDs.
SimulationJobSummary
Description
Summary information for a simulation job.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the simulation job.
- computeType
-
- Type: string
The compute type for the simulation job summary.
- dataSourceNames
-
- Type: Array of strings
The names of the data sources.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the simulation job was last updated.
- name
-
- Type: string
The name of the simulation job.
- robotApplicationNames
-
- Type: Array of strings
A list of simulation job robot application names.
- simulationApplicationNames
-
- Type: Array of strings
A list of simulation job simulation application names.
- status
-
- Type: string
The status of the simulation job.
SimulationSoftwareSuite
Description
Information about a simulation software suite.
Members
- name
-
- Type: string
The name of the simulation software suite.
SimulationRuntime
is the only supported value. - version
-
- Type: string
The version of the simulation software suite. Not applicable for
SimulationRuntime
.
Source
Description
Information about a source.
Members
- architecture
-
- Type: string
The taget processor architecture for the application.
- etag
-
- Type: string
A hash of the object specified by
s3Bucket
ands3Key
. - s3Bucket
-
- Type: string
The s3 bucket name.
- s3Key
-
- Type: string
The s3 object key.
SourceConfig
Description
Information about a source configuration.
Members
- architecture
-
- Type: string
The target processor architecture for the application.
- s3Bucket
-
- Type: string
The Amazon S3 bucket name.
- s3Key
-
- Type: string
The s3 object key.
TemplateLocation
Description
Information about a template location.
Members
- s3Bucket
-
- Required: Yes
- Type: string
The Amazon S3 bucket name.
- s3Key
-
- Required: Yes
- Type: string
The list of S3 keys identifying the data source files.
TemplateSummary
Description
Summary information for a template.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the template.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the template was created.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the template was last updated.
- name
-
- Type: string
The name of the template.
- version
-
- Type: string
The version of the template that you're using.
ThrottlingException
Description
AWS RoboMaker is temporarily unable to process the request. Try your call again.
Members
- message
-
- Type: string
Tool
Description
Information about a tool. Tools are used in a simulation job.
Members
- command
-
- Required: Yes
- Type: string
Command-line arguments for the tool. It must include the tool executable name.
- exitBehavior
-
- Type: string
Exit behavior determines what happens when your tool quits running.
RESTART
will cause your tool to be restarted.FAIL
will cause your job to exit. The default isRESTART
. - name
-
- Required: Yes
- Type: string
The name of the tool.
- streamOutputToCloudWatch
-
- Type: boolean
Boolean indicating whether logs will be recorded in CloudWatch for the tool. The default is
False
. - streamUI
-
- Type: boolean
Boolean indicating whether a streaming session will be configured for the tool. If
True
, AWS RoboMaker will configure a connection so you can interact with the tool as it is running in the simulation. It must have a graphical user interface. The default isFalse
.
UploadConfiguration
Description
Provides upload configuration information. Files are uploaded from the simulation job to a location you specify.
Members
- name
-
- Required: Yes
- Type: string
A prefix that specifies where files will be uploaded in Amazon S3. It is appended to the simulation output location to determine the final path.
For example, if your simulation output location is
s3://amzn-s3-demo-bucket
and your upload configuration name isrobot-test
, your files will be uploaded tos3://amzn-s3-demo-bucket/<simid>/<runid>/robot-test
. - path
-
- Required: Yes
- Type: string
Specifies the path of the file(s) to upload. Standard Unix glob matching rules are accepted, with the addition of
**
as a super asterisk. For example, specifying/var/log/**.log
causes all .log files in the/var/log
directory tree to be collected. For more examples, see Glob Library. - uploadBehavior
-
- Required: Yes
- Type: string
Specifies when to upload the files:
- UPLOAD_ON_TERMINATE
-
Matching files are uploaded once the simulation enters the
TERMINATING
state. Matching files are not uploaded until all of your code (including tools) have stopped.If there is a problem uploading a file, the upload is retried. If problems persist, no further upload attempts will be made.
- UPLOAD_ROLLING_AUTO_REMOVE
-
Matching files are uploaded as they are created. They are deleted after they are uploaded. The specified path is checked every 5 seconds. A final check is made when all of your code (including tools) have stopped.
VPCConfig
Description
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 two subnet IDs.
Members
- assignPublicIp
-
- Type: boolean
A boolean indicating whether to assign a public IP address.
- securityGroups
-
- Type: Array of strings
A list of one or more security groups IDs in your VPC.
- subnets
-
- Required: Yes
- Type: Array of strings
A list of one or more subnet IDs in your VPC.
VPCConfigResponse
Description
VPC configuration associated with your simulation job.
Members
- assignPublicIp
-
- Type: boolean
A boolean indicating if a public IP was assigned.
- securityGroups
-
- Type: Array of strings
A list of security group IDs associated with the simulation job.
- subnets
-
- Type: Array of strings
A list of subnet IDs associated with the simulation job.
- vpcId
-
- Type: string
The VPC ID associated with your simulation job.
WorldConfig
Description
Configuration information for a world.
Members
- world
-
- Type: string
The world generated by Simulation WorldForge.
WorldCount
Description
The number of worlds that will be created. You can configure the number of unique floorplans and the number of unique interiors for each floor plan. For example, if you want 1 world with 20 unique interiors, you set floorplanCount = 1
and interiorCountPerFloorplan = 20
. This will result in 20 worlds (floorplanCount
* interiorCountPerFloorplan)
.
If you set floorplanCount = 4
and interiorCountPerFloorplan = 5
, there will be 20 worlds with 5 unique floor plans.
Members
- floorplanCount
-
- Type: int
The number of unique floorplans.
- interiorCountPerFloorplan
-
- Type: int
The number of unique interiors per floorplan.
WorldExportJobSummary
Description
Information about a world export job.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world export job.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world export job was created.
- outputLocation
-
- Type: OutputLocation structure
The output location.
- status
-
- Type: string
The status of the world export job.
- Pending
-
The world export job request is pending.
- Running
-
The world export job is running.
- Completed
-
The world export job completed.
- Failed
-
The world export job failed. See
failureCode
for more information. - Canceled
-
The world export job was cancelled.
- Canceling
-
The world export job is being cancelled.
- worlds
-
- Type: Array of strings
A list of worlds.
WorldFailure
Description
Information about a failed world.
Members
- failureCode
-
- Type: string
The failure code of the world export job if it failed:
- InternalServiceError
-
Internal service error.
- LimitExceeded
-
The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.
- ResourceNotFound
-
The specified resource could not be found.
- RequestThrottled
-
The request was throttled.
- InvalidInput
-
An input parameter in the request is not valid.
- failureCount
-
- Type: int
The number of failed worlds.
- sampleFailureReason
-
- Type: string
The sample reason why the world failed. World errors are aggregated. A sample is used as the
sampleFailureReason
.
WorldGenerationJobSummary
Description
Information about a world generator job.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world generator job.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world generator job was created.
- failedWorldCount
-
- Type: int
The number of worlds that failed.
- status
-
- Type: string
The status of the world generator job:
- Pending
-
The world generator job request is pending.
- Running
-
The world generator job is running.
- Completed
-
The world generator job completed.
- Failed
-
The world generator job failed. See
failureCode
for more information. - PartialFailed
-
Some worlds did not generate.
- Canceled
-
The world generator job was cancelled.
- Canceling
-
The world generator job is being cancelled.
- succeededWorldCount
-
- Type: int
The number of worlds that were generated.
- template
-
- Type: string
The Amazon Resource Name (arn) of the world template.
- worldCount
-
- Type: WorldCount structure
Information about the world count.
WorldSummary
Description
Information about a world.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the world.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time, in milliseconds since the epoch, when the world was created.
- generationJob
-
- Type: string
The Amazon Resource Name (arn) of the world generation job.
- template
-
- Type: string
The Amazon Resource Name (arn) of the world template.