Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Gérez les FleetWise véhicules AWS IoT
Les véhicules sont des exemples de modèles de véhicules. Les véhicules doivent être créés à partir d'un modèle de véhicule et associés à un manifeste du décodeur. Vehicles télécharge un ou plusieurs flux de données dans le cloud. Par exemple, un véhicule peut envoyer des données sur le kilométrage, la température du moteur et l'état du chauffage vers le cloud. Chaque véhicule contient les informations suivantes :
`vehicleName`
Un identifiant identifiant le véhicule.
N'ajoutez pas d'informations personnelles identifiables (PII) ou d'autres informations confidentielles ou sensibles dans le nom de votre véhicule. Les noms des véhicules sont accessibles par d'autres AWS services, notamment Amazon CloudWatch. Les noms des véhicules ne sont pas destinés à être utilisés pour des données privées ou sensibles.
`modelManifestARN`
Le nom de ressource Amazon (ARN) d'un modèle de véhicule (manifeste du modèle). Chaque véhicule est créé à partir d'un modèle de véhicule. Les véhicules créés à partir du même modèle de véhicule sont constitués du même groupe de signaux hérités du modèle de véhicule. Ces signaux sont définis et normalisés dans le catalogue de signaux.
`decoderManifestArn`
L'ARN du manifeste du décodeur. Un manifeste de décodage fournit des informations de décodage que l' AWS IoT FleetWise peut utiliser pour transformer les données de signal brutes (données binaires) en valeurs lisibles par l'homme. Un manifeste du décodeur doit être associé à un modèle de véhicule. AWS L'IoT FleetWise utilise le même manifeste de décodage pour décoder les données brutes des véhicules créés sur la base du même modèle de véhicule.
`attributes`
Les attributs sont des paires clé-valeur qui contiennent des informations statiques. Les véhicules peuvent contenir des attributs hérités du modèle du véhicule. Vous pouvez ajouter des attributs supplémentaires pour distinguer un véhicule individuel des autres véhicules créés à partir du même modèle de véhicule. Par exemple, si vous avez une voiture noire, vous pouvez spécifier la valeur suivante pour un attribut :`{"color": "black"}`.
Les attributs doivent être définis dans le modèle de véhicule associé avant de pouvoir les ajouter à des véhicules individuels.
Pour plus d'informations sur les modèles de véhicules, les manifestes des décodeurs et les attributs, consultez[Modélisez AWS des FleetWise véhicules IoT](vehicle-modeling.md).
AWS L'IoT FleetWise fournit les opérations d'API suivantes que vous pouvez utiliser pour créer et gérer des véhicules.
+ [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)— Crée un nouveau véhicule.
+ [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)— Crée un ou plusieurs nouveaux véhicules.
+ [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)— Met à jour un véhicule existant.
+ [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)— Met à jour un ou plusieurs véhicules existants.
+ [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)— Supprime un véhicule existant.
+ [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)— Récupère une liste paginée des résumés de tous les véhicules.
+ [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)— Récupère des informations sur un véhicule.
**Topics**
+ [Fournir AWS des FleetWise véhicules IoT](provision-vehicles.md)
+ [Sujets réservés dans le domaine de AWS l'IoT FleetWise](reserved-topics.md)
+ [Créez un FleetWise véhicule AWS IoT](create-vehicle.md)
+ [Créez plusieurs FleetWise véhicules AWS IoT](create-vehicles-cli.md)
+ [Mettre à jour un FleetWise véhicule AWS IoT](update-vehicle-cli.md)
+ [Mettre à jour plusieurs FleetWise véhicules AWS IoT](update-vehicles-cli.md)
+ [Supprimer un FleetWise véhicule AWS IoT](delete-vehicle.md)
+ [Obtenez des informations sur les FleetWise véhicules AWS IoT](get-vehicle-information-cli.md)
# Fournir AWS des FleetWise véhicules IoT
Le FleetWise logiciel Edge Agent pour AWS l'IoT exécuté dans votre véhicule collecte et transfère les données vers le cloud. AWS L'IoT FleetWise s'intègre AWS IoT Core pour garantir une communication sécurisée entre le logiciel Edge Agent et le cloud via MQTT. Chaque véhicule correspond à un AWS IoT objet. Vous pouvez utiliser un AWS IoT objet existant pour créer un véhicule ou configurer AWS l'IoT FleetWise pour créer automatiquement un AWS IoT objet pour votre véhicule. Pour de plus amples informations, veuillez consulter [Créez un FleetWise véhicule AWS IoT](create-vehicle.md).
AWS IoT Core prend en charge [l'authentification](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html) et [l'autorisation](https://docs.aws.amazon.com/iot/latest/developerguide/iot-authorization.html) qui permettent de contrôler en toute sécurité l'accès aux FleetWise ressources de AWS l'IoT. Les véhicules peuvent utiliser des certificats X.509 pour s'authentifier (se connecter) afin d'utiliser l' AWS IoT FleetWise et des AWS IoT Core politiques pour obtenir l'autorisation (disposer d'autorisations) pour effectuer des actions spécifiques.
## Authentifier les véhicules
Vous pouvez créer des AWS IoT Core politiques pour authentifier vos véhicules.
**Pour authentifier votre véhicule**
+ Pour créer une AWS IoT Core politique, exécutez la commande suivante.
+ *policy-name*Remplacez-le par le nom de la politique que vous souhaitez créer.
+ *file-name*Remplacez-le par le nom du fichier JSON contenant la AWS IoT Core politique.
```
aws iot create-policy --policy-name policy-name --policy-document file://file-name.json
```
### Exemple AWS IoT Core de politique
Avant d'utiliser l'exemple de politique, procédez comme suit :
+ Remplacez *us-east-1* par la AWS région dans laquelle vous avez créé FleetWise des ressources AWS IoT.
+ Remplacez *111122223333* par votre identifiant de AWS compte.
Cet exemple inclut les sujets réservés par AWS l'IoT FleetWise. Vous devez ajouter les sujets à la politique. Pour de plus amples informations, veuillez consulter [Sujets réservés dans le domaine de AWS l'IoT FleetWise](reserved-topics.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Connect"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:client/${iot:Connection.Thing.ThingName}"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Publish"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/checkins",
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/signals"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Subscribe"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topicfilter/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/collection_schemes",
"arn:aws:iot:us-east-1:111122223333:topicfilter/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/decoder_manifests"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Receive"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/collection_schemes",
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/decoder_manifests"
]
}
]
}
```
------
## Autoriser les véhicules
Vous pouvez créer des certificats X.509 pour autoriser vos véhicules.
**Pour autoriser votre véhicule**
**Important**
Nous vous recommandons de créer un nouveau certificat pour chaque véhicule.
1. Pour créer une paire de clés RSA et émettre un certificat X.509, exécutez la commande suivante.
+ Remplacez *cert* par le nom du fichier qui enregistre le contenu de sortie de commande de CertificatePEM.
+ Remplacez *public-key* par le nom du fichier qui enregistre le contenu de sortie de commande de KeyPair. PublicKey.
+ Remplacez *private-key* par le nom du fichier qui enregistre le contenu de sortie de commande de KeyPair. PrivateKey.
```
aws iot create-keys-and-certificate \
--set-as-active \
--certificate-pem-outfile cert.pem \
--public-key-outfile public-key.key" \
--private-key-outfile private-key.key"
```
1. Copiez le nom de ressource Amazon (ARN) du certificat à partir de la sortie.
1. Pour associer la politique au certificat, exécutez la commande suivante.
+ *policy-name*Remplacez-le par le nom de la AWS IoT Core politique que vous avez créée.
+ *certificate-arn*Remplacez-le par l'ARN du certificat que vous avez copié.
```
aws iot attach-policy \
--policy-name policy-name\
--target "certificate-arn"
```
1. Pour associer le certificat à l'objet, exécutez la commande suivante.
+ Remplacez *thing-name* par le nom de votre AWS IoT objet ou l'identifiant de votre véhicule.
+ *certificate-arn*Remplacez-le par l'ARN du certificat que vous avez copié.
```
aws iot attach-thing-principal \
--thing-name thing-name \
--principal "certificate-arn"
```
# Sujets réservés dans le domaine de AWS l'IoT FleetWise
**Important**
L'accès à certaines FleetWise fonctionnalités de AWS l'IoT est actuellement restreint. Pour de plus amples informations, veuillez consulter [AWS Disponibilité des régions et des fonctionnalités dans AWS l'IoT FleetWise](fleetwise-regions.md).
AWS L'IoT FleetWise se réserve l'utilisation des rubriques suivantes. Si le sujet réservé le permet, vous pouvez vous y abonner ou y publier. Toutefois, vous ne pouvez pas créer de nouveaux sujets commençant par le signe dollar (\$1). Si vous utilisez des opérations de publication ou d'abonnement non prises en charge avec des sujets réservés, la connexion peut être interrompue.
| Rubrique | Opération du client autorisée | Description |
| --- | --- | --- |
| `$aws/iotfleetwise/vehicles/vehicleName/checkins` | Publication | Le logiciel Edge Agent publie des informations sur l'état du véhicule dans cette rubrique. Les informations relatives à l'état du véhicule sont échangées au format Protobuf (Protobuf). Pour plus d'informations, consultez le [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/signals` | Publication | Le logiciel Edge Agent publie des signaux relatifs à cette rubrique. Les informations de signal sont échangées au format Protobuf (Protobuf) dans des tampons de protocole. Pour plus d'informations, consultez le [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/collection_schemes` | S’abonner | AWS L'IoT FleetWise publie des schémas de collecte de données sur ce sujet. Les véhicules utilisent ces systèmes de collecte de données. |
| `$aws/iotfleetwise/vehicles/vehicleName/decoder_manifests` | S’abonner | AWS L'IoT FleetWise publie des manifestes de décodeurs sur ce sujet. Les véhicules consomment ces manifestes du décodeur. |
| `$aws/iotfleetwise/vehicles/vehicleName/command/request` | S’abonner | AWS L'IoT FleetWise publie des demandes d'exécution de commandes dans cette rubrique. Les véhicules consomment ensuite ces demandes de commande. |
| `$aws/iotfleetwise/vehicles/vehicleName/command/response` | Publication | Le logiciel Edge Agent publie les réponses aux commandes du véhicule relatives à cette rubrique. Les réponses aux commandes sont échangées sous forme de tampons de protocole (Protobuf). Pour plus d'informations, consultez le [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/command/notification` | S’abonner | AWS L'IoT FleetWise publie des mises à jour sur l'état des commandes sur cette rubrique. Les notifications sont envoyées au format JSON. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/config` | S’abonner | AWS L'IoT FleetWise publie des configurations de modèles d'état dans cette rubrique. Les véhicules utilisent ces configurations de modèles d'état. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/data` | Publication | Le logiciel Edge Agent publie les données collectées à partir des signaux dans cette rubrique. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_state/$state_template_name/data` | S’abonner | AWS L'IoT FleetWise publie les données collectées à partir des signaux configurés dans la section spécifiée `$state_template_name` dans cette rubrique. Les mises à jour peuvent être partielles. Par exemple, si une association de modèles d'état contient plusieurs signaux avec la stratégie de mise à jour en cours de modification, seuls les signaux modifiés sont contenus dans un message donné. Les informations de signal sont échangées au format Protobuf (Protobuf) dans des tampons de protocole. Pour plus d'informations, consultez le [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
# Créez un FleetWise véhicule AWS IoT
**Important**
L'accès à certaines FleetWise fonctionnalités de AWS l'IoT est actuellement restreint. Pour de plus amples informations, veuillez consulter [AWS Disponibilité des régions et des fonctionnalités dans AWS l'IoT FleetWise](fleetwise-regions.md).
Vous pouvez utiliser la FleetWise console ou l'API AWS IoT pour créer un véhicule.
**Important**
Avant de commencer, vérifiez les points suivants :
Vous devez avoir un modèle de véhicule et le statut du modèle de véhicule doit être le cas`ACTIVE`. Pour de plus amples informations, veuillez consulter [Gérez les modèles FleetWise de véhicules AWS IoTModèles de véhicules](vehicle-models.md).
Le modèle de votre véhicule doit être associé à un manifeste du décodeur, et le statut du manifeste du décodeur doit être le même. `ACTIVE` Pour de plus amples informations, veuillez consulter [Gérez les AWS manifestes des FleetWise décodeurs IoT](decoder-manifests.md).
**Topics**
+ [Création d'un véhicule (console)](#create-vehicle-console)
+ [Création d'un véhicule (AWS CLI)](#create-vehicle-cli)
## Création d'un véhicule (console)
Vous pouvez utiliser la FleetWise console AWS IoT pour créer un véhicule.
**Pour créer un véhicule**
1. Ouvrez la [ FleetWise console AWS IoT](https://console.aws.amazon.com/iotfleetwise).
1. Dans le volet de navigation, sélectionnez **Véhicules**.
1. Sur la page récapitulative du véhicule, choisissez **Créer un véhicule**, puis effectuez les étapes suivantes.
**Topics**
+ [Étape 1 : définir les propriétés du véhicule](#define-vehicle-properties-console)
+ [Étape 2 : Configuration du certificat du véhicule](#define-vehicle-certificate-console)
+ [Étape 3 : associer des politiques au certificat](#attach-vehicle-policy-console)
+ [Étape 4 : vérifier et créer](#review-and-create-vehicle-console)
### Étape 1 : définir les propriétés du véhicule
Au cours de cette étape, vous nommez le véhicule et vous l'associez au manifeste du modèle et au manifeste du décodeur.
1. Entrez un nom unique pour le véhicule.
**Important**
Un véhicule correspond à n'importe quelle AWS IoT chose. Si un objet portant ce nom existe déjà, choisissez **Associer le véhicule à un objet IoT** pour le mettre à jour avec le véhicule. Vous pouvez également choisir un autre nom de véhicule et AWS l'IoT FleetWise créera automatiquement un nouvel élément pour le véhicule.
1. Choisissez un modèle de véhicule (manifeste du modèle) dans la liste.
1. Choisissez un manifeste de décodeur dans la liste. Le manifeste du décodeur est associé au modèle du véhicule.
1. (Facultatif) Pour associer des attributs de véhicule, choisissez **Ajouter des attributs**. Si vous ignorez cette étape, vous devez ajouter des attributs après la création du véhicule avant de pouvoir le déployer dans des campagnes.
1. (Facultatif) Pour associer des étiquettes au véhicule, choisissez **Ajouter une nouvelle étiquette**. Vous pouvez également ajouter des tags après la création du véhicule.
1. Choisissez **Suivant**.
### Étape 2 : Configuration du certificat du véhicule
Pour utiliser votre véhicule en tant qu' AWS IoT objet, vous devez configurer un certificat de véhicule accompagné d'une politique. Si vous ignorez cette étape, vous devez configurer un certificat une fois le véhicule créé avant de pouvoir le déployer dans des campagnes.
1. Choisissez **Générer automatiquement un nouveau certificat (recommandé).**
1. Choisissez **Suivant**.
### Étape 3 : associer des politiques au certificat
Attachez une politique au certificat que vous avez configuré à l'étape précédente.
1. Pour **Politiques**, entrez un nom de stratégie existant. Pour créer une nouvelle politique, choisissez **Create policy**.
1. Choisissez **Suivant**.
### Étape 4 : vérifier et créer
Vérifiez les configurations du véhicule, puis choisissez **Create vehicle**.
**Important**
Une fois le véhicule créé, vous devez télécharger le certificat et les clés. Vous utiliserez le certificat et la clé privée pour connecter le véhicule au FleetWise logiciel Edge Agent for AWS IoT.
## Création d'un véhicule (AWS CLI)
Lorsque vous créez un véhicule, vous devez utiliser un modèle de véhicule associé à un manifeste de décodeur. Vous pouvez utiliser l'opération [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)API pour créer un véhicule. L'exemple suivant repose sur AWS CLI.
Pour créer un véhicule, exécutez la commande suivante.
Remplacez *file-name* par le nom du fichier .json contenant la configuration du véhicule.
```
aws iotfleetwise create-vehicle --cli-input-json file://file-name.json
```
**Example — configuration du véhicule**
+ (Facultatif) La `associationBehavior` valeur peut être l'une des suivantes :
+ `CreateIotThing`— Lorsque votre véhicule est créé, AWS l'IoT crée FleetWise automatiquement un AWS IoT objet portant le nom de l'identifiant de votre véhicule.
+ `ValidateIotThingExists`— Utilisez un AWS IoT objet existant pour créer un véhicule.
Pour créer un AWS IoT objet, exécutez la commande suivante. *thing-name*Remplacez-le par le nom de l'objet que vous souhaitez créer.
```
aws iot create-thing --thing-name thing-name
```
Si ce n'est pas spécifié, AWS l'IoT crée FleetWise automatiquement AWS IoT quelque chose pour votre véhicule.
**Important**
Assurez-vous que l' AWS IoT objet est approvisionné une fois le véhicule créé. Pour de plus amples informations, veuillez consulter [Fournir AWS des FleetWise véhicules IoT](provision-vehicles.md).
+ Remplacez *vehicle-name* par l'un des modèles suivants.
+ Le nom de votre AWS IoT objet s'il `associationBehavior` est configuré pour`ValidateIotThingExists`.
+ L'ID du véhicule pour lequel il doit être créé `associationBehavior` est configuré`CreateIotThing`.
L'identifiant du véhicule peut comporter de 1 à 100 caractères. Caractères valides : a—z, A—Z, 0—9, tiret (‐), trait de soulignement (\$1) et deux-points (:).
+ *model-manifest-ARN*Remplacez-le par l'ARN de votre modèle de véhicule (manifeste du modèle).
+ Remplacez *decoder-manifest-ARN* par l'ARN du manifeste du décodeur associé au modèle de véhicule spécifié.
+ (Facultatif) Vous pouvez ajouter des attributs supplémentaires pour distinguer ce véhicule des autres véhicules créés à partir du même modèle de véhicule. Par exemple, si vous avez une voiture électrique, vous pouvez spécifier la valeur suivante pour un attribut :`{"fuelType": "electric"}`.
**Important**
Les attributs doivent être définis dans le modèle de véhicule associé avant de pouvoir les ajouter à des véhicules individuels.
```
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
}
```
**Example — associe un modèle d'état au véhicule**
Vous pouvez associer des [modèles d'état](state-templates.md) au véhicule pour permettre la collecte de mises à jour d'état à partir du véhicule dans le cloud en utilisant le `stateTemplates` champ.
Dans cet exemple, il `stateTemplateUpdateStrategy` peut s'agir de l'un des suivants :
+ `periodic`: vous permet de définir un taux fixe auquel le logiciel Edge Agent enverra les mises à jour des signaux au cloud (le logiciel Edge Agent enverra les mises à jour même si la valeur du signal n'a pas changé entre les mises à jour).
+ `onChange`: Le logiciel Edge Agent envoie des mises à jour du signal chaque fois que le signal change.
```
aws iotfleetwise create-vehicle --cli-input-json file://create-vehicle.json
```
Où le `create-vehicle.json` fichier contient (par exemple) :
```
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
},
"stateTemplates": [
{
"identifier": "state-template-name",
"stateTemplateUpdateStrategy": {
"periodic": {
"stateTemplateUpdateRate": {
"unit": "SECOND",
"value": 10
}
}
}
}
]
}
```
Si vous avez [activé le chiffrement](key-management.md) à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'opération `CreateVehicle` d'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"
]
}
]
}
```
------
# Créez plusieurs FleetWise véhicules AWS IoT
Vous pouvez utiliser l'opération [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)API pour créer plusieurs véhicules à la fois. L'exemple suivant repose sur AWS CLI.
Pour créer plusieurs véhicules, exécutez la commande suivante.
*file-name*Remplacez-le par le nom du fichier .json qui contient les configurations de plusieurs véhicules.
```
aws iotfleetwise batch-create-vehicle --cli-input-json file://file-name.json
```
**Example — configurations des véhicules**
```
{
"vehicles": [
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
},
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
}
]
}
```
Vous pouvez créer jusqu'à 10 véhicules pour chaque opération par lot. Pour plus d'informations sur la configuration du véhicule, voir[Créez un FleetWise véhicule AWS IoT](create-vehicle.md).
Si vous avez [activé le chiffrement](key-management.md) à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'opération `BatchCreateVehicle` d'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"
]
}
]
}
```
------
# Mettre à jour un FleetWise véhicule AWS IoT
**Important**
L'accès à certaines FleetWise fonctionnalités de AWS l'IoT est actuellement restreint. Pour de plus amples informations, veuillez consulter [AWS Disponibilité des régions et des fonctionnalités dans AWS l'IoT FleetWise](fleetwise-regions.md).
Vous pouvez utiliser l'opération [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)API pour mettre à jour un véhicule existant. L'exemple suivant repose sur AWS CLI.
Pour mettre à jour un véhicule, exécutez la commande suivante.
*file-name*Remplacez-le par le nom du fichier .json contenant la configuration de votre véhicule.
```
aws iotfleetwise update-vehicle --cli-input-json file://file-name.json
```
**Example — configuration du véhicule**
+ *vehicle-name*Remplacez-le par l'identifiant du véhicule que vous souhaitez mettre à jour.
+ (Facultatif) *model-manifest-ARN* Remplacez-le par l'ARN du modèle de véhicule (manifeste du modèle) que vous utilisez pour remplacer le modèle de véhicule utilisé.
+ (Facultatif) *decoder-manifest-ARN* Remplacez-le par l'ARN du manifeste de votre décodeur associé au nouveau modèle de véhicule que vous avez spécifié.
+ (Facultatif) Remplacez *attribute-update-mode* par les attributs du véhicule.
+ `Merge`— Fusionnez les nouveaux attributs dans les attributs existants en mettant à jour les attributs existants avec de nouvelles valeurs et en ajoutant de nouveaux attributs s'ils n'existent pas.
Par exemple, si un véhicule possède les attributs suivants :`{"color": "black", "fuelType": "electric"}`, et que vous mettez à jour le véhicule avec les attributs suivants :`{"color": "", "fuelType": "gasoline", "model": "x"}`, le véhicule mis à jour possède les attributs suivants :`{"fuelType": "gasoline", "model": "x"}`.
+ `Overwrite`— Remplacez les attributs existants par de nouveaux attributs.
Par exemple, si un véhicule possède les attributs suivants :`{"color": "black", "fuelType": "electric"}`, et que vous mettez à jour le véhicule avec l'`{"model": "x"}`attribut, le véhicule mis à jour possède l'`{"model": "x"}`attribut.
Cela est obligatoire si des attributs sont présents dans l'entrée.
+ (Facultatif) Pour ajouter de nouveaux attributs ou mettre à jour les attributs existants avec de nouvelles valeurs, configurez`attributes`. Par exemple, si vous avez une voiture électrique, vous pouvez spécifier la valeur suivante pour un attribut :`{"fuelType": "electric"}`.
Pour supprimer des attributs, configurez `attributeUpdateMode` sur`Merge`.
**Important**
Les attributs doivent être définis dans le modèle de véhicule associé avant de pouvoir les ajouter à des véhicules individuels.
```
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"attributeUpdateMode": "attribute-update-mode"
}
}
```
**Example — ajouter ou supprimer des modèles d'état associés au véhicule**
Vous pouvez associer des modèles d'état supplémentaires ou supprimer des associations existantes du véhicule à l'aide des champs suivants :
+ `stateTemplatesToAdd`
+ `stateTemplatesToRemove`
```
aws iotfleetwise update-vehicle --cli-input-json file://update-vehicle.json
```
Où le `update-vehicle.json` fichier contient (par exemple) :
```
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"attributeUpdateMode": "attribute-update-mode",
"stateTemplatesToAdd": [
{
"identifier": "state-template-name",
"stateTemplateUpdateStrategy": {
"onChange": {}
}
}
],
"stateTemplatesToRemove": ["state-template-name"]
}
```
Si vous avez [activé le chiffrement](key-management.md) à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'opération `UpdateVehicle` d'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"
]
}
]
}
```
------
# Mettre à jour plusieurs FleetWise véhicules AWS IoT
Vous pouvez utiliser l'opération [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)API pour mettre à jour plusieurs véhicules existants en même temps. L'exemple suivant repose sur AWS CLI.
Pour mettre à jour plusieurs véhicules, exécutez la commande suivante.
*file-name*Remplacez-le par le nom du fichier .json qui contient les configurations de plusieurs véhicules.
```
aws iotfleetwise batch-update-vehicle --cli-input-json file://file-name.json
```
**Example — configurations des véhicules**
```
{
"vehicles": [
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"mergeAttributes": true,
"attributes": {
"key": "value"
}
},
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"mergeAttributes": true,
"attributes": {
"key": "value"
}
}
]
}
```
Vous pouvez mettre à jour jusqu'à 10 véhicules pour chaque opération par lot. Pour plus d'informations sur la configuration de chaque véhicule, consultez[Mettre à jour un FleetWise véhicule AWS IoT](update-vehicle-cli.md).
Si vous avez [activé le chiffrement](key-management.md) à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'opération `BatchUpdateVehicle` d'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"
]
}
]
}
```
------
# Supprimer un FleetWise véhicule AWS IoT
Vous pouvez utiliser la FleetWise console ou l'API AWS IoT pour supprimer des véhicules.
**Important**
Après la suppression d'un véhicule, AWS l'IoT le retire FleetWise automatiquement des flottes et des campagnes associées. Pour plus d’informations, consultez [Gérez les flottes dans l'IoT AWS FleetWise](fleets.md) et [Collectez AWS des FleetWise données IoT grâce à des campagnes](campaigns.md). Cependant, le véhicule existe toujours en tant qu'objet ou est toujours associé à un objet dans AWS IoT Core. Pour obtenir des instructions sur la suppression d'un objet, voir [Supprimer un objet](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html#delete-thing) dans le *Guide du AWS IoT Core développeur*.
## Supprimer un véhicule (console)
Vous pouvez utiliser la FleetWise console AWS IoT pour supprimer un véhicule.
**Pour supprimer un véhicule**
1. Ouvrez la [ FleetWise console AWS IoT](https://console.aws.amazon.com/iotfleetwise).
1. Dans le volet de navigation, sélectionnez **Véhicules**.
1. Sur la page **Véhicules**, sélectionnez le bouton situé à côté du véhicule que vous souhaitez supprimer.
1. Sélectionnez **Delete (Supprimer)**.
1. Dans **Supprimer **vehicle-name****, entrez le nom du véhicule, puis choisissez **Supprimer**.
## Supprimer un véhicule (AWS CLI)
Vous pouvez utiliser l'opération [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)API pour supprimer un véhicule. L'exemple suivant utilise AWS CLI.
Pour supprimer un véhicule, exécutez la commande suivante.
*vehicle-name*Remplacez-le par l'identifiant du véhicule que vous souhaitez supprimer.
```
aws iotfleetwise delete-vehicle --vehicle-name vehicle-name
```
### Vérifier la suppression du véhicule
Vous pouvez utiliser le fonctionnement de l'[ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)API pour vérifier si un véhicule a été supprimé. L'exemple suivant repose sur AWS CLI.
Pour récupérer une liste paginée des résumés de tous les véhicules, exécutez la commande suivante.
```
aws iotfleetwise list-vehicles
```
Si vous avez [activé le chiffrement](key-management.md) à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'opération `ListVehicles` d'API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Obtenez des informations sur les FleetWise véhicules AWS IoT
**Important**
L'accès à certaines FleetWise fonctionnalités de AWS l'IoT est actuellement restreint. Pour de plus amples informations, veuillez consulter [AWS Disponibilité des régions et des fonctionnalités dans AWS l'IoT FleetWise](fleetwise-regions.md).
Vous pouvez utiliser l'opération [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)API pour récupérer des informations sur le véhicule. L'exemple suivant repose sur AWS CLI.
Pour récupérer les métadonnées d'un véhicule, exécutez la commande suivante.
*vehicle-name*Remplacez-le par l'identifiant du véhicule que vous souhaitez récupérer.
```
aws iotfleetwise get-vehicle --vehicle-name vehicle-name
```
**Note**
Cette opération est [cohérente à terme](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). En d'autres termes, les modifications apportées au véhicule peuvent ne pas être prises en compte immédiatement.
Vous pouvez utiliser l'opération [GetVehicleStatus](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicleStatus.html)API pour récupérer l'état des ressources associées à un véhicule. L'exemple suivant repose sur AWS CLI.
Pour récupérer l'état des ressources associées à un véhicule, exécutez la commande suivante.
+ Remplacez *vehicle-name* par l'ID du véhicule auquel les ressources sont associées.
+ Remplacez *type* par le type de ressource dont vous souhaitez récupérer le statut. Les valeurs valides pour `type` sont `CAMPAIGN`, `STATE_TEMPLATE` et `DECODER`.
```
aws iotfleetwise get-vehicle-status --vehicle-name vehicle-name --type type
```
Si vous avez [activé le chiffrement](key-management.md) à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer les opérations `GetVehicleStatus` d'API `GetVehicle` ou.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------