本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 AWS IoT FleetWise 中管理機群
機群代表一組車輛。沒有相關聯車輛的機群是空的實體。您必須先將車輛與機群建立關聯，才能使用機群同時管理多部車輛。車輛可以屬於多個機群。您可以藉由部署行銷活動，控制要從車輛機群收集哪些資料，以及何時收集資料。如需詳細資訊，請參閱[使用行銷活動收集 AWS IoT FleetWise 資料](campaigns.md)。
機群包含下列資訊。
`fleetId`
機群的 ID。
(選用) `description`
可協助您尋找機群的描述。
`signalCatalogArn`
訊號目錄的 Amazon Resource Name (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 IoT FleetWise 機群](create-fleet-cli.md)
+ [將 an AWS IoT FleetWise 車輛與機群建立關聯](associate-vehicle-cli.md)
+ [取消工業 AWS IoT FleetWise 車輛與機群的關聯](disassociate-vehicle-cli.md)
+ [更新 an AWS IoT FleetWise 機群](update-fleet-cli.md)
+ [刪除 AWS IoT FleetWise 機群](delete-fleet-cli.md)
+ [Get AWS IoT FleetWise 機群資訊](get-fleet-information-cli.md)
# 建立 AWS IoT FleetWise 機群
您可以使用 [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html) API 操作來建立機群。下列範例使用 AWS CLI。
**重要**
您必須先擁有訊號目錄，才能建立機群。如需詳細資訊，請參閱[建立 AWS IoT FleetWise 訊號目錄](create-signal-catalog.md)。
若要建立機群，請執行下列命令。
+ 將 *fleet-id* 取代為您建立之機群的 ID。
機群 ID 必須是唯一的，且有 1-100 個字元。有效字元：字母 (A-Z 和 a-z)、數字 (0-9)、冒號 (：)、破折號 (-) 和底線 (\$1)。
+ （選用） 將*描述*取代為描述。
描述可以有 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"
]
}
]
}
```
------
# 將 an AWS IoT FleetWise 車輛與機群建立關聯
您可以使用 [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html) API 操作，將車輛與機群建立關聯。下列範例使用 AWS CLI。
**重要**
您必須先擁有 車輛和機群，才能將車輛與機群建立關聯。如需詳細資訊，請參閱[Manage AWS IoT 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 IoT 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"
]
}
]
}
```
------
# 更新 an AWS IoT FleetWise 機群
您可以使用 [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html) API 操作來更新機群的描述。以下範例使用 AWS CLI。
若要更新機群，請執行下列命令。
+ 將 *fleet-id* 取代為您更新之機群的 ID。
+ 將*描述*取代為新的描述。
描述可以有 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 IoT FleetWise 機群
您可以使用 [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html) API 操作來刪除機群。下列範例使用 AWS CLI。
**重要**
刪除機群之前，請確定其沒有相關聯的車輛。如需如何取消車輛與機群的關聯的指示，請參閱 [取消工業 AWS IoT 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"
]
}
]
}
```
------
# Get AWS IoT 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"
]
}
]
}
```
------