Esempio di query per oggetti - AWS IoT Core

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempio di query per oggetti

Specificare query in una stringa di query utilizzando una sintassi di query. Le query vengono passate all'API SearchIndex. La tabella seguente elenca alcune stringhe di query di esempio.

Stringa di query Risultato
abc

Esegue una query per il valore "abc" in qualsiasi campo di registro, copia shadow (copia shadow classica senza nome e copia shadow con nome) o violazioni Device Defender.
thingName:myThingName

Interrogazioni per un oggetto con nome "». myThingName
thingName:my*

Query per oggetti con nomi che iniziano per "mio".
thingName:ab?

Query per oggetti con nomi che contengono "ab" più un altro carattere (ad esempio "aba", "abb", "abc" e così via).
thingTypeName:aa

Query per oggetti associati al tipo "aa".
thingGroupNames:a Interrogazioni relative a elementi il cui gruppo di oggetti principale o il nome del gruppo di fatturazione è «a».
thingGroupNames:a* Interrogazioni relative a elementi il cui nome del gruppo di oggetti principale o del gruppo di fatturazione corrisponde allo schema «a*».
attributes.myAttribute:75

Query per oggetti con un attributo denominato "myAttribute" il cui valore è 75.
attributes.myAttribute:[75 TO 80]

Query per oggetti con un attributo denominato "myAttribute" il cui valore è compreso in un intervallo numerico (75-80, inclusi).
attributes.myAttribute:{75 TO 80]

Query per oggetti con un attributo denominato "myAttribute" il cui valore è compreso in un intervallo numerico (>75 e <=80).
attributes.serialNumber:["abcd" TO "abcf"]

Query per oggetti con un attributo denominato "serialNumber" il cui valore è compreso in un intervallo di stringhe alfanumeriche. Questa query restituisce gli oggetti con un attributo "serialNumber" con i valori "abcd", "abce" o "abcf".
attributes.myAttribute:i*t

Query per oggetti con un attributo denominato "myAttribute" il cui valore è "i", seguito da un numero qualsiasi di caratteri, seguito da 't'.
attributes.attr1:abc AND attributes.attr2<5 NOT attributes.attr3>10

Query per oggetti che combinano termini usando espressioni booleane. Questa query restituisce gli oggetti che hanno un attributo denominato "attr1" con un valore "abc", un attributo denominato "attr2" il cui valore è minore di 5 e un attributo denominato "attr3" che non è maggiore di 10.
shadow.hasDelta:true

Query per oggetti con una copia shadow senza nome che ha un elemento delta.
NOT attributes.model:legacy

Query per oggetti in cui l'attributo denominato "model" non è "legacy".
shadow.reported.stats.battery:{70 TO 100} (v2 OR v3) NOT attributes.model:legacy

Query per oggetti con le caratteristiche seguenti:

  • L'attributo stats.battery della copia shadow dell'oggetto ha un valore compreso tra 70 e 100.

  • Il testo "v2" o "v3" è contenuto in un nome di oggetto, un nome di tipo o in valori di attributo.

  • L'attributo model dell'oggetto non è impostato su "legacy".
shadow.reported.myvalues:2

Query per oggetti in cui la serie myvalues nella sezione reported della copia shadow contiene un valore pari a 2.
shadow.reported.location:* NOT shadow.desired.stats.battery:*

Query per oggetti con le caratteristiche seguenti:

  • L'attributo location è presente nella sezione reported della copia shadow.

  • L'attributo stats.battery non è presente nella sezione desired della copia shadow.
shadow.name.<shadowName>.hasDelta:true

Query per oggetti che hanno una copia shadow con nome specificato e anche un elemento delta.

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

Query per oggetti che hanno una copia shadow con nome specificato e anche una proprietà del filamento desiderata.

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

Query per oggetti che hanno una copia shadow con nome specificato e dove l'attributo location è presente nella sezione segnalata di shadow con nome.
connectivity.connected:true

Interroga tutti i dispositivi connessi.
connectivity.connected:false Interroga tutti i dispositivi disconnessi.
connectivity.connected:true AND connectivity.timestamp : [1557651600000 TO 1557867600000] Interroga tutti i dispositivi connessi con un timestamp di connessione >= 1557651600000 e <= 1557867600000. I timestamp vengono forniti in millisecondi dall'epoch.
connectivity.connected:false AND connectivity.timestamp : [1557651600000 TO 1557867600000] Interroga tutti i dispositivi disconnessi con un timestamp di disconnessione >= 1557651600000 e <= 1557867600000. I timestamp vengono forniti in millisecondi dall'epoch.
connectivity.connected:true AND connectivity.timestamp > 1557651600000 Interroga tutti i dispositivi connessi con un timestamp di connessione > 557651600000. I timestamp vengono forniti in millisecondi dall'epoch.
connectivity.connected:* Ricerche di tutti i dispositivi con informazioni sulla connettività.
connectivity.disconnectReason:* Query per tutti i dispositivi con connettività disconnectReason presente.
connectivity.disconnectReason:CLIENT_INITIATED_DISCONNECT Query per tutti i dispositivi disconnessi a causa di CLIENT_INITIATED_DISCONNECT.
deviceDefender.violationCount:[0 TO 100] Le query per oggetti con violazioni di Device Defender contano valori che rientrano nell'intervallo numerico (0-100, incluso).
deviceDefender.<device-SecurityProfile>.disconnectBehavior.inViolation:true Query per oggetti che sono in violazione del comportamento disconnectBehavior come definito nel profilo di sicurezza device-SecurityProfile. Nota che InViolation:false non è una query valida.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2 Interrogazioni relative a elementi che violano il comportamento disconnectBehavior definito nel dispositivo del profilo di sicurezza, SecurityProfile con un valore dell'evento dell'ultima violazione maggiore di 2.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000

Interrogazioni relative a elementi che violano il comportamento disconnectBehavior definito nel dispositivo del profilo di sicurezza, SecurityProfile con un ultimo evento di violazione dopo un periodo di tempo specificato.

shadow.name.gps-tracker.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Interrogazioni per oggetti che si trovano entro la distanza radiale di 15,5 km dalle coordinate di 47.6204, -122.3491. Questa stringa di query si applica a quando i dati sulla posizione vengono archiviati in un'ombra denominata.
shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Interrogazioni per oggetti che si trovano entro la distanza radiale di 15,5 km dalle coordinate di 47.6204, -122.3491. Questa stringa di query si applica a quando i dati sulla posizione vengono archiviati in un'ombra classica.