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.
# Préparation de l'indexation de la flotte
Avec l'indexation de AWS IoT flotte, vous pouvez rechercher et agréger des données en utilisant le nom réservé shadow (`$package`). Vous pouvez également regrouper AWS IoT des objets en interrogeant les [groupes [Ombre nommée réservée](preparing-to-use-software-package-catalog.md#reserved-named-shadow) d'objets dynamiques](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html). Par exemple, vous pouvez trouver des informations sur AWS IoT les éléments qui utilisent une version de package spécifique, sur lesquels aucune version de package spécifique n'est installée ou sur lesquels aucune version de package n'est installée. Vous pouvez obtenir des informations supplémentaires en combinant les attributs. Par exemple, identifier les objets dotés d'une version spécifique et d'un type d'objet spécifique (tels que la version 1.0.0 et le type d'objet pump\$1sensor). Pour plus d'informations, veuillez consulter la rubrique [Fleet indexing](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html).
## Définir l'`$package`ombre comme source de données
Pour utiliser l'indexation de flotte avec le Catalogue de Logiciels, vous devez activer l'indexation de flotte, définir l'ombre nommée comme source de données et définir `$package` comme filtre d'ombre nommé. Si vous n'avez pas activé l'indexation de la flotte, vous pouvez l'activer dans le cadre de ce processus. A partir de[AWS IoT Core](https://console.aws.amazon.com/iot/home) dans la console, ouvrez **Paramètres**, choisissez **Gérer l'indexation**, puis **Ajouter des ombres nommées**, **Ajouter des packages logiciels et des versions de l'appareil**, et **Mettre à jour**. Pour de plus amples informations, veuillez consulter la section [Gestion de l'indexation des objets.](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#thing-index)
Vous pouvez également activer l'indexation de la flotte lorsque vous créez votre premier package. Lorsque la boîte de dialogue **Activer les dépendances pour la gestion des packages** apparaît, choisissez l'option permettant d'ajouter les packages logiciels et les versions des appareils en tant que sources de données pour l'indexation de la flotte. En sélectionnant cette option, vous activez également l'indexation de la flotte.
**Note**
L'activation de l'indexation de la flotte pour le Catalogue de Logiciels entraîne des coûts de service standard. Pour plus d'informations, consultez [AWS IoT Device Management Pricing](https://aws.amazon.com/iot-device-management/pricing/)
## Métriques affichées dans la console
![\[Image des métriques standard\]](http://docs.aws.amazon.com/fr_fr/iot/latest/developerguide/images/package-catalog-discovery-metrics.png)
Sur la page de détails du package logiciel de la AWS IoT console, le panneau **Discovery** affiche les métriques standard ingérées dans l'`$package`ombre.
+ Le tableau de **distribution des versions actuelles** indique le nombre d'appareils et le pourcentage des 10 versions de package les plus récentes associées à un AWS IoT objet parmi tous les appareils associés à ce package logiciel. **Remarque :** Si le package logiciel comporte plus de versions que celles indiquées dans le tableau, vous pouvez les trouver regroupées dans la section **Autres**.
+ Le **graphique historique** indique le nombre d'appareils associés aux versions de package sélectionnées sur une période donnée. Le graphique est initialement vide jusqu'à ce que vous sélectionniez jusqu'à 5 versions de package et que vous définissiez la plage de dates et l'intervalle de temps. Pour sélectionner les paramètres du graphique, choisissez **Réglages**. Les données affichées dans le **graphique historique** peuvent être différentes de celles du graphique de **distribution des versions actuelles** en raison de la différence entre le nombre de versions de package affichées et également parce que vous pouvez choisir les versions de package à analyser dans le **graphique historique**. **Remarque :** Lorsque vous sélectionnez une version de package à visualiser, elle est prise en compte dans le nombre maximum de limites de métriques de flotte. Pour plus d'informations, consultez [Limites et quotas d'indexation de la flotte.](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
Pour une autre méthode permettant de mieux comprendre la collecte de la distribution des versions de packages, voir [Collecte de la distribution des versions de packages via `getBucketsAggregation`](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-fleet-indexing.html#package-version-distribution).
## Modèles de requête
L'indexation de flottes avec Software Package Catalog utilise la plupart des fonctionnalités standard prises en charge (telles que les termes, les phrases et les champs de recherche). Cependant, les opérateurs de comparaison (par exemple, inférieur à `<` et supérieur à`>`) et les `range` requêtes ne sont pas disponibles pour la `version` clé nommée shadow (`$package`) réservée. Ces requêtes sont disponibles pour la `attributes` clé. Pour plus d'informations, consultez [Syntaxe de requête.](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html).
### Exemple de données
**Remarque :** pour plus d'informations sur l'ombre nommée réservée et sa structure, consultez [Ombre nommée réservée](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-to-use-software-package-catalog.html#reserved-named-shadow).
Dans cet exemple, un premier périphérique est nommé `AnyThing` et les packages suivants sont installés :
+ Package logiciel : `SamplePackage`
Version du package : `1.0.0`
Un ID de package : `1111`
L'ombre ressemble à ce qui suit :
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
}
}
}
}
```
Un deuxième périphérique est nommé `AnotherThing` et le package suivant est installé :
+ Package logiciel : `SamplePackage`
Version du package : `1.0.0`
Un ID de package : `1111`
+ Package logiciel : `OtherPackage`
Version du package : `1.2.5`
Un ID de package : `2222`
L'ombre ressemble à ce qui suit :
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
},
"OtherPackage": {
"version": "1.2.5",
"attributes": {
"s3UrlForOtherPackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile2",
"packageID": "2222"
}
},
}
}
}
```
### Exemples de requêtes
Le tableau suivant répertorie des exemples de requêtes basés sur les exemples d'ombres du périphérique pour `AnyThing` et`AnotherThing`. Pour plus d'informations, consultez [Exemples de requêtes](https://docs.aws.amazon.com/iot/latest/developerguide/example-queries.html).
**Dernière version de AWS IoT Device Tester for FreeRTOS**
| **Informations demandées** | **Interrogation** | **Result** |
| --- | --- | --- |
| Éléments sur lesquels une version de package spécifique est installée | `shadow.name.$package.reported.SamplePackage.version:1.0.0` | `AnyThing`, `OtherThing` |
| Éléments pour lesquels aucune version de package spécifique n'est installée | `NOT shadow.name.$package.reported.OtherPackage.version:1.2.5` | `AnyThing` |
| Tout appareil utilisant une version de package dont l'ID de package est supérieur à 1500 | `shadow.name.$package.reported.*.attributes.packageID>1500"` | `OtherThing` |
| Éléments sur lesquels un package spécifique est installé et sur lesquels plusieurs packages sont installés | `shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2` | `OtherThing` |
## Collecte de la distribution des versions de packages via `getBucketsAggregation`
Outre le panneau **Discovery** de la AWS IoT console, vous pouvez également obtenir des informations sur la distribution des versions de packages à l'aide de l'opération [https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html](https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html)API. Pour obtenir des informations de distribution de la version du package, vous devez procéder comme suit :
+ Définissez un champ personnalisé dans l'indexation de la flotte pour chaque progiciel. **Remarque :** La création de champs personnalisés est prise en compte dans les [AWS IoT quotas du service d'indexation de la flotte](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
+ Formatez le champ personnalisé comme suit :
`shadow.name.$package.reported..version`
Pour plus d'informations, consultez la section [Champs personnalisés](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#custom-field) dans l'indexation des AWS IoT flottes.