本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在物联网中 AWS 管理车队 FleetWise
车队表示一组车辆。没有关联车辆的车队是一个空实体。在使用车队同时管理多辆车之前，必须将车辆与该车队相关联。一辆车可以归属于多个车队。您可以通过部署活动来控制从车队中收集哪些数据以及何时收集数据。有关更多信息，请参阅 [通过活动收集 AWS 物联网 FleetWise 数据](campaigns.md)。
车队包含以下信息。
`fleetId`
车队的 ID。
（可选）`description`
可帮助您找到车队的描述。
`signalCatalogArn`
信号目录的 Amazon 资源名称（ARN）。
AWS IoT FleetWise 提供了以下 API 操作，您可以使用这些操作来创建和管理舰队。
+ [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html)— 创建一组包含相同信号组的车辆。
+ [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html)— 将车辆与车队关联起来。
+ [DisassociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DisassociateVehicle.html)— 断开车辆与车队的关联。
+ [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html)— 更新现有舰队的描述。
+ [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html)— 删除现有舰队。
+ [ListFleets](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleets.html)— 检索所有舰队摘要的分页列表。
+ [ListFleetsForVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleetsForVehicle.html)— 检索车辆所属的所有车队 IDs 的分页列表。
+ [ListVehiclesInFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehiclesInFleet.html)— 检索车队中所有车辆的分页摘要列表。
+ [GetFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetFleet.html)— 检索有关舰队的信息。
**Topics**
+ [创建 AWS 物联网 FleetWise 舰队](create-fleet-cli.md)
+ [将 AWS 物联网 FleetWise 车辆与车队关联](associate-vehicle-cli.md)
+ [解除 AWS 物联网 FleetWise 车辆与车队的关联](disassociate-vehicle-cli.md)
+ [更新 AWS 物联网 FleetWise 舰队](update-fleet-cli.md)
+ [删除 AWS 物联网 FleetWise 舰队](delete-fleet-cli.md)
+ [获取 AWS 物联网 FleetWise 车队信息](get-fleet-information-cli.md)
# 创建 AWS 物联网 FleetWise 舰队
您可以使用 [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html)API 操作来创建车队。以下示例使用 AWS CLI。
**重要**
在创建车队之前，您必须拥有信号目录。有关更多信息，请参阅 [创建 AWS 物联网 FleetWise 信号目录](create-signal-catalog.md)。
要创建车队，请运行以下命令。
+ *fleet-id*替换为您正在创建的舰队的 ID。
车队 ID 必须唯一，且包含 1-100 个字符。有效字符：字母（A-Z 和 a-z）、数字（0-9）、冒号 (:)、短划线 (-) 和下划线 (\$1)。
+ （可选）*description*用描述替换。
描述可包含 1-2048 个字符。
+ *signal-catalog-arn*替换为信号目录的 ARN。
```
aws iotfleetwise create-fleet \
--fleet-id fleet-id \
--description description \
--signal-catalog-arn signal-catalog-arn
```
如果您[启用了使用客户托管 AWS KMS 密钥的加密](key-management.md)，请包括以下政策声明，以便您的角色可以调用 `CreateFleet` API 操作。
------
#### [ 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"
]
}
]
}
```
------
# 将 AWS 物联网 FleetWise 车辆与车队关联
您可以使用 [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html)API 操作将车辆与车队相关联。以下示例使用 AWS CLI。
**重要**
拥有车辆和车队后，才能将车辆与车队关联起来。有关更多信息，请参阅 [管理 AWS 物联网 FleetWise 车辆](vehicles.md)。
如果您将车辆与活动所针对的车队相关联， AWS IoT FleetWise 会自动将活动部署到该车辆。
要将车辆与车队关联，请运行以下命令。
+ *fleet-id*替换为舰队的 ID。
+ *vehicle-name*替换为车辆的 ID。
```
aws iotfleetwise associate-vehicle-fleet --fleet-id fleet-id --vehicle-name vehicle-name
```
如果您[启用了使用客户托管 AWS KMS 密钥的加密](key-management.md)，请包括以下政策声明，以便您的角色可以调用 `AssociateVehicleFleet` API 操作。
------
#### [ 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"
]
}
]
}
```
------
# 解除 AWS 物联网 FleetWise 车辆与车队的关联
您可以使用 [DisassociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DisassociateVehicle.html)API 操作取消车辆与车队的关联。以下示例使用 AWS CLI。
要解除车辆与车队的关联，请运行以下命令。
+ *fleet-id*替换为舰队的 ID。
+ *vehicle-name*替换为车辆的 ID。
```
aws iotfleetwise disassociate-vehicle-fleet --fleet-id fleet-id --vehicle-name vehicle-name
```
如果您[启用了使用客户托管 AWS KMS 密钥的加密](key-management.md)，请包括以下政策声明，以便您的角色可以调用 `DisassociateVehicleFleet` API 操作。
------
#### [ 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"
]
}
]
}
```
------
# 更新 AWS 物联网 FleetWise 舰队
您可以使用 [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html)API 操作来更新队列的描述。下面的示例使用了 AWS CLI。
要更新车队，请运行以下命令。
+ *fleet-id*替换为您要更新的舰队的 ID。
+ *description*替换为新的描述。
描述可包含 1-2048 个字符。
```
aws iotfleetwise update-fleet --fleet-id fleet-id --description description
```
如果您[启用了使用客户托管 AWS KMS 密钥的加密](key-management.md)，请包括以下政策声明，以便您的角色可以调用 `UpdateFleet` API 操作。
------
#### [ 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"
]
}
]
}
```
------
# 删除 AWS 物联网 FleetWise 舰队
您可以使用 [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html)API 操作删除舰队。以下示例使用 AWS CLI。
**重要**
在删除车队之前，请确保它没有关联的车辆。有关如何解除车辆与车队关联的说明，请参阅[解除 AWS 物联网 FleetWise 车辆与车队的关联](disassociate-vehicle-cli.md)。
要删除车队，请运行以下命令。
*fleet-id*替换为您要删除的舰队的 ID。
```
aws iotfleetwise delete-fleet --fleet-id fleet-id
```
## 验证舰队已删除
您可以使用 [ListFleets](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleets.html)API 操作来验证队列是否已被删除。下面的示例使用了 AWS CLI。
要检索所有车队的分页摘要列表，请运行以下命令。
```
aws iotfleetwise list-fleets
```
如果您[启用了使用客户托管 AWS KMS 密钥的加密](key-management.md)，请包括以下政策声明，以便您的角色可以调用 `ListFleets` API 操作。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# 获取 AWS 物联网 FleetWise 车队信息
您可以使用 [ListFleetsForVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleetsForVehicle.html)API 操作来检索车辆所属的所有车队 IDs 的分页列表。下面的示例使用了 AWS CLI。
要检索该车辆所属 IDs 的所有车队的分页列表，请运行以下命令。
*vehicle-name*替换为车辆的 ID。
```
aws iotfleetwise list-fleets-for-vehicle \
--vehicle-name vehicle-name
```
如果您[启用了使用客户托管 AWS KMS 密钥的加密](key-management.md)，请包括以下政策声明，以便您的角色可以调用 `ListFleetsForVehicle` API 操作。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
您可以使用 [ListVehiclesInFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehiclesInFleet.html)API 操作来检索车队中所有车辆的分页摘要列表。下面的示例使用了 AWS CLI。
要检索车队中所有车辆的分页摘要列表，请运行以下命令。
*fleet-id*替换为舰队的 ID。
```
aws iotfleetwise list-vehicles-in-fleet \
--fleet-id fleet-id
```
如果您[启用了使用客户托管 AWS KMS 密钥的加密](key-management.md)，请包括以下政策声明，以便您的角色可以调用 `ListVehiclesInFleet` API 操作。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
您可以使用 [GetFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetFleet.html)API 操作来检索舰队信息。下面的示例使用了 AWS CLI。
要检索车队的元数据，请运行以下命令。
*fleet-id*替换为舰队的 ID。
```
aws iotfleetwise get-fleet \
--fleet-id fleet-id
```
**注意**
此操作具有[最终一致性](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf)。换句话说，可能不会立即反映对车队进行的更改。
如果您[启用了使用客户托管 AWS KMS 密钥的加密](key-management.md)，请包括以下政策声明，以便您的角色可以调用 `GetFleet` API 操作。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------