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

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

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

Updates a vehicle.

Access to certain Amazon Web Services IoT FleetWise features is currently gated. For more information, see [Amazon Web Services Region and feature availability](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/fleetwise-regions.html) in the _Amazon Web Services IoT FleetWise Developer Guide_.

## Headers

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

## Request body

- UpdateVehicleRequest
  - `vehicleName` string, required — The unique ID of the vehicle to update.
  - `modelManifestArn` string — The ARN of a vehicle model (model manifest) associated with the vehicle.
  - `decoderManifestArn` string — The ARN of the decoder manifest associated with this vehicle.
  - `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 state templates 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.
  - `stateTemplatesToRemove` ResourceIdentifier[] — Remove state templates 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

- UpdateVehicleResponse
  - `vehicleName` string — The ID of the updated vehicle.
  - `arn` string — The ARN of the updated vehicle.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ConflictException
- `483` — LimitExceededException
- `484` — ThrottlingException
- `485` — ValidationException
- `486` — 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/revisions/0f1f9edeb409/schema)