Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

batch_create_vehicle

batch_create_vehicle(**kwargs)

Creates a group, or batch, of vehicles.

Note

You must specify a decoder manifest and a vehicle model (model manifest) for each vehicle.

For more information, see Create multiple vehicles (AWS CLI) in the Amazon Web Services IoT FleetWise Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.batch_create_vehicle(
    vehicles=[
        {
            'vehicleName': 'string',
            'modelManifestArn': 'string',
            'decoderManifestArn': 'string',
            'attributes': {
                'string': 'string'
            },
            'associationBehavior': 'CreateIotThing'|'ValidateIotThingExists',
            'tags': [
                {
                    'Key': 'string',
                    'Value': 'string'
                },
            ]
        },
    ]
)
Parameters
vehicles (list) --

[REQUIRED]

A list of information about each vehicle to create. For more information, see the API data type.

  • (dict) --

    Information about the vehicle to create.

    • vehicleName (string) -- [REQUIRED]

      The unique ID of the vehicle to create.

    • modelManifestArn (string) -- [REQUIRED]

      The ARN of the vehicle model (model manifest) to create the vehicle from.

    • decoderManifestArn (string) -- [REQUIRED]

      The Amazon Resource Name (ARN) of a decoder manifest associated with the vehicle to create.

    • attributes (dict) --

      Static information about a vehicle in a key-value pair. For example: "engine Type" : "v6"

      • (string) --
        • (string) --
    • associationBehavior (string) --

      An option to create a new Amazon Web Services IoT thing when creating a vehicle, or to validate an existing thing as a vehicle.

    • tags (list) --

      Metadata which can be used to manage the vehicle.

      • (dict) --

        A set of key/value pairs that are used to manage the resource.

        • Key (string) -- [REQUIRED]

          The tag's key.

        • Value (string) -- [REQUIRED]

          The tag's value.

Return type
dict
Returns
Response Syntax
{
    'vehicles': [
        {
            'vehicleName': 'string',
            'arn': 'string',
            'thingArn': 'string'
        },
    ],
    'errors': [
        {
            'vehicleName': 'string',
            'code': 'string',
            'message': 'string'
        },
    ]
}

Response Structure

  • (dict) --
    • vehicles (list) --

      A list of information about a batch of created vehicles. For more information, see the API data type.

      • (dict) --

        Information about a created vehicle.

        • vehicleName (string) --

          The unique ID of the vehicle to create.

        • arn (string) --

          The ARN of the created vehicle.

        • thingArn (string) --

          The ARN of a created or validated Amazon Web Services IoT thing.

    • errors (list) --

      A list of information about creation errors, or an empty list if there aren't any errors.

      • (dict) --

        An HTTP error resulting from creating a vehicle.

        • vehicleName (string) --

          The ID of the vehicle with the error.

        • code (string) --

          An HTTP error code.

        • message (string) --

          A description of the HTTP error.

Exceptions

  • IoTFleetWise.Client.exceptions.InternalServerException
  • IoTFleetWise.Client.exceptions.LimitExceededException
  • IoTFleetWise.Client.exceptions.ThrottlingException
  • IoTFleetWise.Client.exceptions.ValidationException
  • IoTFleetWise.Client.exceptions.AccessDeniedException