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 AWS IoT lors de l'indexation des flottes, vous pouvez rechercher et agréger des données en utilisant le nom réservé shadow ($package). Vous pouvez également grouper AWS IoT objets en interrogeant les groupes Ombre nommée réservée d'objets dynamiques. Par exemple, vous pouvez trouver des informations sur les AWS IoT les objets utilisent une version de package spécifique, aucune version de package spécifique n'est installée ou 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_sensor). Pour plus d'informations, veuillez consulter la rubrique Fleet indexing.

Définir l'$packageombre 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. De AWS IoT Coredans la console, ouvrez les 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.

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.

Métriques affichées dans la console

Sur le AWS IoT page de détails du package logiciel de la console, le panneau Discovery affiche les métriques standard ingérées dans l'$packageombre.

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.

Modèles de requête

L'indexation des flottes avec Software Package Catalog utilise la plupart des fonctionnalités prises en charge (par exemple, les termes, les phrases et les champs de recherche) qui sont standard pour l'indexation des flottes. L'exception est que les requêtes comparison et range ne sont pas disponibles pour la ($package)version clé de l’ombre réservée nommée. Toutefois, ces requêtes sont disponibles pour la attributes clé. Pour plus d'informations, consultez Syntaxe de requête..

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.

Dans cet exemple, un premier périphérique est nommé AnyThing et les packages suivants sont installés :

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é :

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 etAnotherThing. Pour plus d'informations, consultez Exemples de requêtes.

Collecte de la distribution des versions de packages via getBucketsAggregation

Outre le panneau Discovery du AWS IoT console, vous pouvez également obtenir des informations sur la distribution de la version du package en utilisant l'GetBucketsAggregationAPIopération. Pour obtenir des informations de distribution de la version du package, vous devez procéder comme suit :

Pour plus d'informations, consultez la section Champs personnalisés dans AWS IoT indexation du parc de véhicules.