---
title: "POST /#X-Amz-Target=IoTAutobahnControlPlane.BatchUpdateVehicle"
method: POST
path: "/#X-Amz-Target=IoTAutobahnControlPlane.BatchUpdateVehicle"
---

# POST /#X-Amz-Target=IoTAutobahnControlPlane.BatchUpdateVehicle

`POST /#X-Amz-Target=IoTAutobahnControlPlane.BatchUpdateVehicle`

Updates a group, or batch, of vehicles.

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

For more information, see [Update multiple vehicles (AWS CLI)](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/update-vehicles-cli.html) in the _Amazon Web Services IoT FleetWise Developer Guide_.

## Headers

- `X-Amz-Target` 'IoTAutobahnControlPlane.BatchUpdateVehicle', required

## Request body

- BatchUpdateVehicleRequest
  - `vehicles` UpdateVehicleRequestItem[], required — A list of information about the vehicles to update. For more information, see the API data type.
    - `vehicleName` string, required — The unique ID of the vehicle to update.
    - `modelManifestArn` string — The ARN of the vehicle model (model manifest) associated with the vehicle to update.
    - `decoderManifestArn` string — The ARN of the signal decoder manifest associated with the vehicle to update.
    - `attributes` object — <p>Static information about a vehicle in a key-value pair. For example:</p> <p> <code>"engineType"</code> : <code>"1.3 L R2"</code> </p>
    - `attributeUpdateMode` 'Overwrite' | 'Merge' — <p>The method the specified attributes will update the existing attributes on the vehicle. Use<code>Overwite</code> to replace the vehicle attributes with the specified attributes. Or use <code>Merge</code> to combine all attributes.</p> <p>This is required if attributes are present in the input.</p>
    - `stateTemplatesToAdd` StateTemplateAssociation[] — Associate additional state templates to track the state of the vehicle. State templates determine which signal updates the vehicle sends to the cloud.
      - `identifier` string, required — The unique ID of the state template.
      - `stateTemplateUpdateStrategy` StateTemplateUpdateStrategy, required — <p>The update strategy for the state template. Vehicles associated with the state template can stream telemetry data with either an <code>onChange</code> or <code>periodic</code> update strategy. </p> <important> <p>Access to certain Amazon Web Services IoT FleetWise features is currently gated. For more information, see <a href="https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/fleetwise-regions.html">Amazon Web Services Region and feature availability</a> in the <i>Amazon Web Services IoT FleetWise Developer Guide</i>.</p> </important>
        - `periodic` PeriodicStateTemplateUpdateStrategy — Vehicles associated with the state template will stream telemetry data during a specified time period.
          - `stateTemplateUpdateRate` TimePeriod, required — The length of time between state template updates.
            - `unit` 'MILLISECOND' | 'SECOND' | 'MINUTE' | 'HOUR', required — A unit of time.
            - `value` integer, required — A number of time units.
        - `onChange` OnChangeStateTemplateUpdateStrategy — Vehicles associated with the state template will stream telemetry data when there is a change.
    - `stateTemplatesToRemove` ResourceIdentifier[] — Remove existing state template associations from the vehicle.
    - `stateTemplatesToUpdate` StateTemplateAssociation[] — Change the <code>stateTemplateUpdateStrategy</code> of state templates already associated with the vehicle.
      - `identifier` string, required — The unique ID of the state template.
      - `stateTemplateUpdateStrategy` StateTemplateUpdateStrategy, required — <p>The update strategy for the state template. Vehicles associated with the state template can stream telemetry data with either an <code>onChange</code> or <code>periodic</code> update strategy. </p> <important> <p>Access to certain Amazon Web Services IoT FleetWise features is currently gated. For more information, see <a href="https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/fleetwise-regions.html">Amazon Web Services Region and feature availability</a> in the <i>Amazon Web Services IoT FleetWise Developer Guide</i>.</p> </important>
        - `periodic` PeriodicStateTemplateUpdateStrategy — Vehicles associated with the state template will stream telemetry data during a specified time period.
          - `stateTemplateUpdateRate` TimePeriod, required — The length of time between state template updates.
            - `unit` 'MILLISECOND' | 'SECOND' | 'MINUTE' | 'HOUR', required — A unit of time.
            - `value` integer, required — A number of time units.
        - `onChange` OnChangeStateTemplateUpdateStrategy — Vehicles associated with the state template will stream telemetry data when there is a change.

## Response `200`

Success

- BatchUpdateVehicleResponse
  - `vehicles` UpdateVehicleResponseItem[] — <p> A list of information about the batch of updated vehicles. </p> <note> <p>This list contains only unique IDs for the vehicles that were updated.</p> </note>
    - `vehicleName` string — The unique ID of the updated vehicle.
    - `arn` string — The Amazon Resource Name (ARN) of the updated vehicle.
  - `errors` UpdateVehicleError[] — A list of information about errors returned while updating a batch of vehicles, or, if there aren't any errors, an empty list.
    - `vehicleName` string — The ID of the vehicle with the error.
    - `code` integer — The relevant HTTP error code (400+).
    - `message` string — A message associated with the error.

## Other responses

- `480` — InternalServerException
- `481` — LimitExceededException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/iotfleetwise.md) · [All operations](https://skmtc.net/aws/apis/iotfleetwise/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotfleetwise/versions/0f1f9edeb409/schema)