RoboMaker / Client / create_simulation_application_version

create_simulation_application_version#

RoboMaker.Client.create_simulation_application_version(**kwargs)#

Creates a simulation application with a specific revision id.

Request Syntax

response = client.create_simulation_application_version(
    application='string',
    currentRevisionId='string',
    s3Etags=[
        'string',
    ],
    imageDigest='string'
)

Parameters:

application (string) –
[REQUIRED]

The application information for the simulation application.
currentRevisionId (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.
s3Etags (list) –
The Amazon S3 eTag identifier for the zip file bundle that you use to create the simulation application.
- (string) –
imageDigest (string) – The SHA256 digest used to identify the Docker image URI used to created the simulation application.

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'name': 'string',
    'version': 'string',
    'sources': [
        {
            's3Bucket': 'string',
            's3Key': 'string',
            'etag': 'string',
            'architecture': 'X86_64'|'ARM64'|'ARMHF'
        },
    ],
    'simulationSoftwareSuite': {
        'name': 'Gazebo'|'RosbagPlay'|'SimulationRuntime',
        'version': 'string'
    },
    'robotSoftwareSuite': {
        'name': 'ROS'|'ROS2'|'General',
        'version': 'Kinetic'|'Melodic'|'Dashing'|'Foxy'
    },
    'renderingEngine': {
        'name': 'OGRE',
        'version': 'string'
    },
    'lastUpdatedAt': datetime(2015, 1, 1),
    'revisionId': 'string',
    'environment': {
        'uri': 'string'
    }
}

Response Structure

(dict) –
- arn (string) –
  
  The Amazon Resource Name (ARN) of the simulation application.
- name (string) –
  
  The name of the simulation application.
- version (string) –
  
  The version of the simulation application.
- sources (list) –
  
  The sources of the simulation application.
  - (dict) –
    
    Information about a source.
    - s3Bucket (string) –
      
      The s3 bucket name.
    - s3Key (string) –
      
      The s3 object key.
    - etag (string) –
      
      A hash of the object specified by s3Bucket and s3Key.
    - architecture (string) –
      
      The taget processor architecture for the application.
- simulationSoftwareSuite (dict) –
  
  The simulation software suite used by the simulation application.
  - name (string) –
    
    The name of the simulation software suite.
  - version (string) –
    
    The version of the simulation software suite.
- robotSoftwareSuite (dict) –
  
  Information about the robot software suite (ROS distribution).
  - name (string) –
    
    The name of the robot software suite (ROS distribution).
  - version (string) –
    
    The version of the robot software suite (ROS distribution).
- renderingEngine (dict) –
  
  The rendering engine for the simulation application.
  - name (string) –
    
    The name of the rendering engine.
  - version (string) –
    
    The version of the rendering engine.
- lastUpdatedAt (datetime) –
  
  The time, in milliseconds since the epoch, when the simulation application was last updated.
- revisionId (string) –
  
  The revision ID of the simulation application.
- environment (dict) –
  
  The object that contains the Docker image URI used to create the simulation application.
  - uri (string) –
    
    The Docker image URI for either your robot or simulation applications.

Exceptions

RoboMaker.Client.exceptions.InvalidParameterException
RoboMaker.Client.exceptions.IdempotentParameterMismatchException
RoboMaker.Client.exceptions.LimitExceededException
RoboMaker.Client.exceptions.ThrottlingException
RoboMaker.Client.exceptions.InternalServerException