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