翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS IoT FleetWise でフリートを管理する
フリートは、車両のグループを表します。車両が関連付けられていないフリートは空のエンティティです。フリートを使用して複数の車両を同時に管理するには、事前に車両をフリートに関連付ける必要があります。車両は複数のフリートに所属することができます。キャンペーンをデプロイすると、車両のフリートから収集するデータと、データを収集するタイミングを制御できます。詳細については、「[キャンペーンを使用して AWS IoT 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) - 車両が所属しているすべてのフリートの ID をページ分割されたリストとして取得します。
+ [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)
+ [AWS IoT FleetWise 車両をフリートに関連付ける](associate-vehicle-cli.md)
+ [AWS IoT FleetWise 車両とフリートの関連付けを解除する](disassociate-vehicle-cli.md)
+ [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) です。
+ (オプション) *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 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"
]
}
]
}
```
------
# AWS IoT 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 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 オペレーションを使用すると、車両が所属しているすべてのフリートの ID をページ分割されたリストとして取得できます。次の例では AWS CLIを使用しています。
車両が所属しているすべてのフリートの ID をページ分割されたリストとして取得するには、次のコマンドを実行します。
*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"
]
}
]
}
```
------