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

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

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

Retrieves information about a vehicle.

## Headers

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

## Request body

- GetVehicleRequest
  - `vehicleName` string, required — The ID of the vehicle to retrieve information about.

## Response `200`

Success

- GetVehicleResponse
  - `vehicleName` string — The ID of the vehicle.
  - `arn` string — The Amazon Resource Name (ARN) of the vehicle to retrieve information about.
  - `modelManifestArn` string — The ARN of a vehicle model (model manifest) associated with the vehicle.
  - `decoderManifestArn` string — The ARN of a decoder manifest associated with the 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>
  - `stateTemplates` StateTemplateAssociation[] — State templates 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.
  - `creationTime` string, date-time — The time the vehicle was created in seconds since epoch (January 1, 1970 at midnight UTC time).
  - `lastModificationTime` string, date-time — The time the vehicle was last updated in seconds since epoch (January 1, 1970 at midnight UTC time).

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `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)