openapi: 3.0.0 info: version: '2018-06-29' x-release: v4 title: AWS RoboMaker BatchDeleteWorlds BatchDescribeSimulationJob API description: This section provides documentation for the AWS RoboMaker API operations. x-logo: url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: robomaker x-aws-signingName: robomaker x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/robomaker-2018-06-29.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://robomaker.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The RoboMaker multi-region endpoint - url: https://robomaker.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The RoboMaker multi-region endpoint - url: http://robomaker.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The RoboMaker endpoint for China (Beijing) and China (Ningxia) - url: https://robomaker.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The RoboMaker endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: BatchDescribeSimulationJob paths: /batchDescribeSimulationJob: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: BatchDescribeSimulationJob description: Describes one or more simulation jobs. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/BatchDescribeSimulationJobResponse' '480': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '481': description: InvalidParameterException content: application/json: schema: $ref: '#/components/schemas/InvalidParameterException' '482': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '483': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' parameters: [] requestBody: required: true content: application/json: schema: type: object required: - jobs properties: jobs: description: A list of Amazon Resource Names (ARNs) of simulation jobs to describe. type: array items: $ref: '#/components/schemas/Arn' minItems: 1 maxItems: 100 tags: - BatchDescribeSimulationJob components: schemas: Port: type: integer minimum: 1 maximum: 65535 UploadConfiguration: type: object required: - name - path - uploadBehavior properties: name: allOf: - $ref: '#/components/schemas/Name' - description:
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://my-bucket and your upload configuration name is robot-test, your files will be uploaded to s3://my-bucket/<simid>/<runid>/robot-test.
** 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:
allOf:
- $ref: '#/components/schemas/UploadBehavior'
- description: Specifies when to upload the files:
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.
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.
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.
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.
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 is False. '
name:
allOf:
- $ref: '#/components/schemas/Name'
- description: The name of the tool.
command:
allOf:
- $ref: '#/components/schemas/UnrestrictedCommand'
- description: Command-line arguments for the tool. It must include the tool executable name.
streamOutputToCloudWatch:
allOf:
- $ref: '#/components/schemas/BoxedBoolean'
- description: 'Boolean indicating whether logs will be recorded in CloudWatch for the tool. The default is False. '
exitBehavior:
allOf:
- $ref: '#/components/schemas/ExitBehavior'
- description: '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 is RESTART. '
description: Information about a tool. Tools are used in a simulation job.
DataSources:
type: array
items:
$ref: '#/components/schemas/DataSource'
SimulationJob:
type: object
properties:
arn:
allOf:
- $ref: '#/components/schemas/Arn'
- description: The Amazon Resource Name (ARN) of the simulation job.
name:
allOf:
- $ref: '#/components/schemas/Name'
- description: The name of the simulation job.
status:
allOf:
- $ref: '#/components/schemas/SimulationJobStatus'
- description: Status of the simulation job.
lastStartedAt:
allOf:
- $ref: '#/components/schemas/LastStartedAt'
- description: The time, in milliseconds since the epoch, when the simulation job was last started.
lastUpdatedAt:
allOf:
- $ref: '#/components/schemas/LastUpdatedAt'
- description: The time, in milliseconds since the epoch, when the simulation job was last updated.
failureBehavior:
allOf:
- $ref: '#/components/schemas/FailureBehavior'
- description: The failure behavior the simulation job.
Leaves the host running for its maximum timeout duration after a 4XX error code.
Stop the simulation job and terminate the instance.
SimulationJob request.
outputLocation:
allOf:
- $ref: '#/components/schemas/OutputLocation'
- description: Location for output files generated by the simulation job.
loggingConfig:
allOf:
- $ref: '#/components/schemas/LoggingConfig'
- description: The logging configuration.
maxJobDurationInSeconds:
allOf:
- $ref: '#/components/schemas/JobDuration'
- description: The maximum simulation job duration in seconds. The value must be 8 days (691,200 seconds) or less.
simulationTimeMillis:
allOf:
- $ref: '#/components/schemas/SimulationTimeMillis'
- description: The simulation job execution duration in milliseconds.
iamRole:
allOf:
- $ref: '#/components/schemas/IamRole'
- description: '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. '
robotApplications:
allOf:
- $ref: '#/components/schemas/RobotApplicationConfigs'
- description: A list of robot applications.
simulationApplications:
allOf:
- $ref: '#/components/schemas/SimulationApplicationConfigs'
- description: A list of simulation applications.
dataSources:
allOf:
- $ref: '#/components/schemas/DataSources'
- description: The data sources for the simulation job.
tags:
allOf:
- $ref: '#/components/schemas/TagMap'
- description: A map that contains tag keys and tag values that are attached to the simulation job.
vpcConfig:
allOf:
- $ref: '#/components/schemas/VPCConfigResponse'
- description: VPC configuration information.
networkInterface:
allOf:
- $ref: '#/components/schemas/NetworkInterface'
- description: Information about a network interface.
compute:
allOf:
- $ref: '#/components/schemas/ComputeResponse'
- description: Compute information for the simulation job
description: Information about a simulation job.
ExitBehavior:
type: string
enum:
- FAIL
- RESTART
SimulationJobErrorCode:
type: string
enum:
- 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
Arn:
type: string
pattern: arn:.*
minLength: 1
maxLength: 1224
RobotApplicationConfig:
type: object
required:
- application
- launchConfig
properties:
application:
allOf:
- $ref: '#/components/schemas/Arn'
- description: The application information for the robot application.
applicationVersion:
allOf:
- $ref: '#/components/schemas/Version'
- description: The version of the robot application.
launchConfig:
allOf:
- $ref: '#/components/schemas/LaunchConfig'
- description: The launch configuration for the robot application.
uploadConfigurations:
allOf:
- $ref: '#/components/schemas/UploadConfigurations'
- description: The upload configurations for the robot application.
useDefaultUploadConfigurations:
allOf:
- $ref: '#/components/schemas/BoxedBoolean'
- deprecated: true
description: 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.
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.
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.
The location where your files are mounted in the container image.
If you've specified the type of the data source as an Archive, 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 a Prefix, 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 a File, you provide the Amazon S3 path to the file that you're using as your data source.
s3Bucket where output files will be placed.
description: The output location.
S3Key:
type: string
pattern: .*
minLength: 1
maxLength: 1024
LaunchConfig:
type: object
properties:
packageName:
allOf:
- $ref: '#/components/schemas/Command'
- description: The package name.
launchFile:
allOf:
- $ref: '#/components/schemas/Command'
- description: The launch file name.
environmentVariables:
allOf:
- $ref: '#/components/schemas/EnvironmentVariableMap'
- description: The environment variables for the application launch.
portForwardingConfig:
allOf:
- $ref: '#/components/schemas/PortForwardingConfig'
- description: The port forwarding configuration.
streamUI:
allOf:
- $ref: '#/components/schemas/Boolean'
- description: '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. '
command:
allOf:
- $ref: '#/components/schemas/CommandList'
- description: If you've specified General as the value for your RobotSoftwareSuite, you can use this field to specify a list of commands for your container image.
If you've specified SimulationRuntime as the value for your SimulationSoftwareSuite, you can use this field to specify a list of commands for your container image.
A boolean indicating whether to record all ROS topics.
This API is no longer supported and will throw an error if used.