View a markdown version of this page

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

Richiede una cosa con il nome «mio». ThingName
thingName:my*

Query per oggetti con nomi che iniziano per "mio".
thingName:*my

Domande su cose con nomi che finiscono con «mio». L'uso principale dei caratteri jolly è limitato a 1 termine di ricerca per query. Le query che includono un carattere jolly iniziale hanno una lunghezza massima di 100 caratteri.
thingName:*my*

Interrogazioni relative agli elementi che contengono la sottostringa «my». L'uso principale dei caratteri jolly è limitato a 1 termine di ricerca per query. Le query che includono un carattere jolly iniziale hanno una lunghezza massima di 100 caratteri.
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 un gruppo di oggetti principale o a un gruppo di fatturazione denominato «a».
thingGroupNames:a* Richieste di informazioni il cui nome è un gruppo di oggetti principale o un gruppo di fatturazione che corrisponde al modello «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. Tieni presente che in non Violation:false è una query valida.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2 Interroga gli elementi che violano il comportamento disconnectBehavior definito nel dispositivo del profilo di sicurezza, SecurityProfile con un valore dell'ultimo evento di violazione maggiore di 2.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000

Interroga gli 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 Interroga oggetti che si trovano entro una distanza radiale di 15,5 km dalle coordinate 47.6204, -122.3491. Questa stringa di query si applica quando i dati sulla posizione sono archiviati in un'ombra denominata.
shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Interroga elementi che si trovano entro una distanza radiale di 15,5 km dalle coordinate 47.6204, -122.3491. Questa stringa di query si applica quando i dati sulla posizione sono archiviati in un'ombra classica.