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
<a name="example-queries"></a>

Specificare query in una stringa di query utilizzando una sintassi di query. Le query vengono passate all'API [https://docs.aws.amazon.com/iot/latest/apireference/API_SearchIndex.html](https://docs.aws.amazon.com/iot/latest/apireference/API_SearchIndex.html). 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\$1  |  Query per oggetti con nomi che iniziano per "mio".  | 
|  thingName:\$1my  |  Interrogazioni relative a elementi con nomi che terminano con «my». L'uso principale dei caratteri jolly è limitato a 1 termine di query per query. Le interrogazioni che includono un carattere jolly iniziale hanno una lunghezza massima di 100 caratteri.  | 
|  thingName:\$1my\$1  |  Interrogazioni per elementi che contengono la sottostringa «my». L'uso principale dei caratteri jolly è limitato a 1 termine di query per query. Le interrogazioni 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 elementi il cui nome del gruppo di oggetti principale o del gruppo di fatturazione è «a». | 
|  thingGroupNames:a\$1  | Interrogazioni relative a elementi il cui nome del gruppo di oggetti principale o del gruppo di fatturazione corrisponde allo schema «a\$1». | 
|  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:\$175 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\$1t |  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:\$170 TO 100\$1 (v2 OR v3) NOT attributes.model:legacy  |  Query per oggetti con le caratteristiche seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot/latest/developerguide/example-queries.html)  | 
|  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:\$1 NOT shadow.desired.stats.battery:\$1  |  Query per oggetti con le caratteristiche seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot/latest/developerguide/example-queries.html)  | 
|  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:\$1  |  Query per oggetti che hanno una copia shadow con nome specificato e anche una proprietà del filamento desiderata.   | 
|  shadow.name.<shadowName>.reported.location:\$1  |  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:\$1  | Ricerche di tutti i dispositivi con informazioni sulla connettività. | 
|  connectivity.disconnectReason:\$1  | Query per tutti i dispositivi con connettività disconnectReason presente. | 
|  connectivity.disconnectReason:CLIENT\$1INITIATED\$1DISCONNECT  | Query per tutti i dispositivi disconnessi a causa di CLIENT\$1INITIATED\$1DISCONNECT. | 
|  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\$1distance,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\$1distance,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. |