Exemples de requêtes sur des objets - AWS IoT Core

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.

Exemples de requêtes sur des objets

Spécifiez les requêtes dans une chaîne de requête à l'aide d'une syntaxe de requête. Les requêtes sont transmises à l'API SearchIndex. Le tableau ci-après répertorie quelques exemples de chaînes de requête.

Chaîne de requête Résultat
abc

Requêtes pour « abc » dans n'importe quel registre, dans n'importe quel champ shadow (shadow anonyme classique et nommée) ou dans n'importe quel champ de violations de Device Defender.
thingName:myThingName

Requêtes pour un objet portant le nom « myThingName ».
thingName:my*

Requêtes concernant les objets dont le nom commence par « my ».
thingName:ab?

Requêtes concernant les objets dont le nom contient la chaîne « ab » suivie d'un caractère supplémentaire, par exemple : « aba », « abb », « abc », etc.
thingTypeName:aa

Requêtes pour les objets qui sont associés au type « aa ».
thingGroupNames:a Requêtes portant sur des objets dont le nom de groupe d'objets parent ou de groupe de facturation est « a ».
thingGroupNames:a* Requêtes portant sur des objets dont le nom du groupe d'objets parent ou du groupe de facturation correspond au modèle « a* ».
attributes.myAttribute:75

Requêtes concernant les objets qui comportent un attribut nommé « myAttribute » ayant pour valeur 75.
attributes.myAttribute:[75 TO 80]

Requêtes pour des éléments avec un attribut nommé « myAttribute » dont la valeur se situe dans une plage numérique (75 à 80 inclus).
attributes.myAttribute:{75 TO 80]

Requêtes pour les éléments avec un attribut nommé « myAttribute » dont la valeur se situe dans la plage numérique (>75 et <=80).
attributes.serialNumber:["abcd" TO "abcf"]

Requêtes pour des éléments avec un attribut nommé « serialNumber » dont la valeur se trouve dans une plage de chaînes alphanumériques. Cette requête renvoie les objets dont l'attribut « serialNumber » a la valeur « abcd », « abce » ou « abcf ».
attributes.myAttribute:i*t

Requêtes pour des éléments avec un attribut nommé « myAttribute » où la valeur est « i », suivi d'un nombre quelconque de caractères, suivi de « t ».
attributes.attr1:abc AND attributes.attr2<5 NOT attributes.attr3>10

Requêtes concernant les objets qui combinent des termes en utilisant des expressions booléennes. Cette requête renvoie les objets qui comportent un attribut nommé « attr1 » de valeur « abc », un attribut nommé « attr2 » qui est inférieur à 5 et un attribut nommé « attr3 » qui n'est pas supérieur à 10.
shadow.hasDelta:true

Requêtes pour des éléments avec une shadow sans nom comportant un élément delta.
NOT attributes.model:legacy

Requêtes concernant les objets dont l'attribut nommé « model » n'est pas défini sur « legacy ».
shadow.reported.stats.battery:{70 TO 100} (v2 OR v3) NOT attributes.model:legacy

Requêtes concernant les objets possédant les caractéristiques suivantes :

  • L'attribut stats.battery du shadow de l'objet possède une valeur comprise entre 70 et 100.

  • Le texte « v2 » ou « v3 » se retrouve dans le nom, le nom de type ou les valeurs d'attribut de l'objet.

  • L'attribut model de l'objet n'est pas défini sur « legacy ».
shadow.reported.myvalues:2

Requêtes concernant les objets dont la plage myvalues dans la section reported du shadow contient une valeur 2.
shadow.reported.location:* NOT shadow.desired.stats.battery:*

Requêtes concernant les objets possédant les caractéristiques suivantes :

  • L'attribut location figure dans la section reported du shadow.

  • L'attribut stats.battery ne figure pas dans la section desired du shadow.
shadow.name.<shadowName>.hasDelta:true

Requêtes pour les objets qui ont une shadow avec le nom donné et également un élément delta.

shadow.name.<shadowName>.desired.filament:*

Requêtes pour les éléments qui ont une shadow avec le nom donné et également une propriété de filament souhaitée.

shadow.name.<shadowName>.reported.location:*

Requête les objets dotés d'une shadow portant le nom donné et dont l'attribut location existe dans la section signalée de la shadow nommée.
connectivity.connected:true

Requêtes pour tous les appareils connectés.
connectivity.connected:false Requêtes pour tous les appareils déconnectés.
connectivity.connected:true AND connectivity.timestamp : [1557651600000 TO 1557867600000] Requêtes pour tous les appareils connectés avec un horodatage de connexion >= 1557651600000 and <= 1557867600000. Les horodatages sont indiqués en millisecondes depuis l’époque Unix.
connectivity.connected:false AND connectivity.timestamp : [1557651600000 TO 1557867600000] Requêtes pour tous les appareils déconnectés avec un horodatage de déconnexion >= 1557651600000 and <= 1557867600000. Les horodatages sont indiqués en millisecondes depuis l’époque Unix.
connectivity.connected:true AND connectivity.timestamp > 1557651600000 Requêtes pour tous les appareils connectés avec un horodatage de connexion > 1557651600000. Les horodatages sont indiqués en millisecondes depuis l’époque Unix.
connectivity.connected:* Requêtes pour tous les appareils comportant des informations de connectivité.
connectivity.disconnectReason:* Requêtes pour tous les appareils avec connectivité DisconnectReason présente.
connectivity.disconnectReason:CLIENT_INITIATED_DISCONNECT Requêtes pour tous les appareils déconnectés en raison de CLIENT_INITIATED_DISCONNECT.
deviceDefender.violationCount:[0 TO 100] Les requêtes portant sur des objets présentant une valeur de nombre de violations de Device Defender comprise dans la plage numérique (0 à 100, inclus).
deviceDefender.<device-SecurityProfile>.disconnectBehavior.inViolation:true Requêtes concernant des éléments contraires au comportement disconnectBehavior défini dans le profil de sécurité device-SecurityProfile. Notez que Inviolation:false n'est pas une requête valide.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2 Requêtes concernant les éléments qui constituent une violation du comportement disconnectBehavior tel que défini dans le périphérique doté du profil de sécurité, SecurityProfile avec une valeur d'événement de dernière violation supérieure à 2.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000

Requêtes concernant les éléments qui constituent une violation du comportement disconnectBehavior tel que défini dans le périphérique doté du profil de sécurité, SecurityProfile avec un dernier événement de violation après une période spécifiée.

shadow.name.gps-tracker.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Requêtes concernant des objets situés à une distance radiale de 15,5 km des coordonnées 47.6204, -122.3491. Cette chaîne de requête s'applique lorsque vos données de localisation sont stockées dans une shadow nommée.
shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Requêtes concernant des objets situés à une distance radiale de 15,5 km des coordonnées 47.6204, -122.3491. Cette chaîne de requête s'applique lorsque vos données de localisation sont stockées dans un shadow classique.