AWS IoT FleetWise will no longer be open to new customers as of April 30, 2026. Existing AWS IoT FleetWise customers can continue using the service. The [Guidance for Connected Mobility on AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) provides guidance on how to develop and deploy modular services for connected mobility solutions that can be used to achieve equivalent capabilities as AWS IoT FleetWise.
# Manage fleets in AWS IoT FleetWise
A fleet represents a group of vehicles. A fleet without associated vehicles is an empty entity. Before you can use the fleet to manage multiple vehicles at the same time, you must associate vehicles with the fleet. A vehicle can belong to multiple fleets. You can control what data to collect from a fleet of vehicles and when to collect data by deploying a campaign. For more information, see [Collect AWS IoT FleetWise data with campaigns](campaigns.md).
A fleet contains the following information.
`fleetId`
The ID of the fleet.
(Optional) `description`
A description that helps you find the fleet.
`signalCatalogArn`
The Amazon Resource Name (ARN) of the signal catalog.
AWS IoT FleetWise provides the following API operations that you can use to create and manage fleets.
+ [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html) – Creates a group of vehicles that contain the same group of signals.
+ [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html) – Associates a vehicle to a fleet.
+ [DisassociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DisassociateVehicle.html) – Disassociates a vehicle from a fleet.
+ [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html) – Updates the description for an existing fleet.
+ [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html) – Deletes an existing fleet.
+ [ListFleets](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleets.html) – Retrieves a paginated list of summaries of all fleets.
+ [ListFleetsForVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleetsForVehicle.html) – Retrieves a paginated list of IDs of all fleets that the vehicle belongs to.
+ [ListVehiclesInFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehiclesInFleet.html) – Retrieves a paginated list of summaries of all vehicles in a fleet.
+ [GetFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetFleet.html) – Retrieves information about a fleet.
**Topics**
+ [Create an AWS IoT FleetWise fleet](create-fleet-cli.md)
+ [Associate an AWS IoT FleetWise vehicle with a fleet](associate-vehicle-cli.md)
+ [Disassociate an AWS IoT FleetWise vehicle from a fleet](disassociate-vehicle-cli.md)
+ [Update an AWS IoT FleetWise fleet](update-fleet-cli.md)
+ [Delete an AWS IoT FleetWise fleet](delete-fleet-cli.md)
+ [Get AWS IoT FleetWise fleet information](get-fleet-information-cli.md)
# Create an AWS IoT FleetWise fleet
You can use the [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html) API operation to create a vehicle fleet. The following example uses AWS CLI.
**Important**
You must have a signal catalog before you can create a fleet. For more information, see [Create an AWS IoT FleetWise signal catalog](create-signal-catalog.md).
To create a fleet, run the following command.
+ Replace *fleet-id* with the ID of the fleet that you're creating.
The fleet ID must be unique and have 1-100 characters. Valid characters: letters (A-Z and a-z), numbers (0-9), colons (:), dashes (-), and underscores (\$1).
+ (Optional) Replace *description* with a description.
The description can have 1-2048 characters.
+ Replace *signal-catalog-arn* with the ARN of the signal catalog.
```
aws iotfleetwise create-fleet \
--fleet-id fleet-id \
--description description \
--signal-catalog-arn signal-catalog-arn
```
If you [enabled encryption](key-management.md) using a customer managed AWS KMS key, include the following policy statement so that your role can invoke the `CreateFleet` API operation.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Associate an AWS IoT FleetWise vehicle with a fleet
You can use the [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html) API operation to associate a vehicle with a fleet. The following example uses AWS CLI.
**Important**
You must have a vehicle and a fleet before you can associate a vehicle with a fleet. For more information, see [Manage AWS IoT FleetWise vehicles](vehicles.md).
If you associate a vehicle with a fleet that is targeted by a campaign, AWS IoT FleetWise automatically deploys the campaign to the vehicle.
To associate a vehicle with a fleet, run the following command.
+ Replace *fleet-id* with the ID of the fleet.
+ Replace *vehicle-name* with the ID of the vehicle.
```
aws iotfleetwise associate-vehicle-fleet --fleet-id fleet-id --vehicle-name vehicle-name
```
If you [enabled encryption](key-management.md) using a customer managed AWS KMS key, include the following policy statement so that your role can invoke the `AssociateVehicleFleet` API operation.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Disassociate an AWS IoT FleetWise vehicle from a fleet
You can use the [DisassociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DisassociateVehicle.html) API operation to disassociate a vehicle from a fleet. The following example uses AWS CLI.
To disassociate a vehicle with a fleet, run the following command.
+ Replace *fleet-id* with the ID of the fleet.
+ Replace *vehicle-name* with the ID of the vehicle.
```
aws iotfleetwise disassociate-vehicle-fleet --fleet-id fleet-id --vehicle-name vehicle-name
```
If you [enabled encryption](key-management.md) using a customer managed AWS KMS key, include the following policy statement so that your role can invoke the `DisassociateVehicleFleet` API operation.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Update an AWS IoT FleetWise fleet
You can use the [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html) API operation to update the description for a fleet. The following example uses AWS CLI.
To update a fleet, run the following command.
+ Replace *fleet-id* with the ID of the fleet that you're updating.
+ Replace *description* with a new description.
The description can have 1-2048 characters.
```
aws iotfleetwise update-fleet --fleet-id fleet-id --description description
```
If you [enabled encryption](key-management.md) using a customer managed AWS KMS key, include the following policy statement so that your role can invoke the `UpdateFleet` API operation.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Delete an AWS IoT FleetWise fleet
You can use the [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html) API operation to delete a fleet. The following example uses AWS CLI.
**Important**
Before you delete a fleet, make sure it has no associated vehicles. For instructions on how to disassociate a vehicle from a fleet, see [Disassociate an AWS IoT FleetWise vehicle from a fleet](disassociate-vehicle-cli.md).
To delete a fleet, run the following command.
Replace *fleet-id* with the ID of the fleet that you're deleting.
```
aws iotfleetwise delete-fleet --fleet-id fleet-id
```
## Verify fleet deletion
You can use the [ListFleets](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleets.html) API operation to verify if a fleet was deleted. The following example uses the AWS CLI.
To retrieve a paginated list of summaries of all fleets, run the following command.
```
aws iotfleetwise list-fleets
```
If you [enabled encryption](key-management.md) using a customer managed AWS KMS key, include the following policy statement so that your role can invoke the `ListFleets` API operation.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Get AWS IoT FleetWise fleet information
You can use the [ListFleetsForVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleetsForVehicle.html) API operation to retrieve a paginated list of IDs of all fleets that the vehicle belongs to. The following example uses the AWS CLI.
To retrieve a paginated list of IDs of all fleets that the vehicle belongs to, run the following command.
Replace *vehicle-name* with the ID of the vehicle.
```
aws iotfleetwise list-fleets-for-vehicle \
--vehicle-name vehicle-name
```
If you [enabled encryption](key-management.md) using a customer managed AWS KMS key, include the following policy statement so that your role can invoke the `ListFleetsForVehicle` API operation.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
You can use the [ListVehiclesInFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehiclesInFleet.html) API operation to retrieve a paginated list of summaries of all vehicles in a fleet. The following example uses the AWS CLI.
To retrieve a paginated list of summaries of all vehicles in a fleet, run the following command.
Replace *fleet-id* with the ID of the fleet.
```
aws iotfleetwise list-vehicles-in-fleet \
--fleet-id fleet-id
```
If you [enabled encryption](key-management.md) using a customer managed AWS KMS key, include the following policy statement so that your role can invoke the `ListVehiclesInFleet` API operation.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
You can use the [GetFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetFleet.html) API operation to retrieve fleet information. The following example uses the AWS CLI.
To retrieve the metadata of a fleet, run the following command.
Replace *fleet-id* with the ID of the fleet.
```
aws iotfleetwise get-fleet \
--fleet-id fleet-id
```
**Note**
This operation is [eventually consistent](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). In other words, changes to the fleet might not be reflected immediately.
If you [enabled encryption](key-management.md) using a customer managed AWS KMS key, include the following policy statement so that your role can invoke the `GetFleet` API operation.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------