Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejemplo de consultas de objetos
<a name="example-queries"></a>

Especifique las consultas en una cadena de consulta mediante una sintaxis de consulta. Las consultas se pasan a la API [https://docs.aws.amazon.com/iot/latest/apireference/API_SearchIndex.html](https://docs.aws.amazon.com/iot/latest/apireference/API_SearchIndex.html). En la siguiente tabla se enumeran algunas cadenas de consulta de ejemplo.


| Cadena de consulta | Resultado | 
| --- | --- | 
|  abc  |  Consulta “abc” en cualquier campo de registro, sombra (la clásica sombra sin nombre y sombra con nombre) o Device Defender.  | 
|  thingName:myThingName  |  Consulta un elemento con el nombre "myThingName».  | 
|  thingName:my\$1  |  Consulta los objetos cuyos nombres que comienzan por "my".  | 
|  thingName:\$1my  |  Consultas de objetos cuyos nombres finalizan por “my”. El uso de caracteres comodín al principio está limitado a un término de consulta por consulta. Las consultas que incluyen un carácter comodín al principio tienen una longitud máxima de 100 caracteres.  | 
|  thingName:\$1my\$1  |  Consultas de objetos que incluyen la subcadena “my”. El uso de caracteres comodín al principio está limitado a un término de consulta por consulta. Las consultas que incluyen un carácter comodín al principio tienen una longitud máxima de 100 caracteres.  | 
|  thingName:ab?  |  Consulta los objetos cuyos nombres tienen “ab“ además de un carácter adicional (por ejemplo: “aba”, “abb”, “abc”, etc.)  | 
|  thingTypeName:aa  |  Consulta los objetos que están asociados con el tipo “aa”.  | 
|  thingGroupNames:a  | Consulta los objetos con nombre de grupo de objetos principal o grupo de facturación “a”. | 
|  thingGroupNames:a\$1  | Consulta los objetos con nombre de grupo de objetos principal o grupo de facturación que coincide con el patrón “a\$1”. | 
|  attributes.myAttribute:75  |  Consulta los objetos con un atributo denominado "myAttribute" que tiene el valor 75.  | 
|  attributes.myAttribute:[75 TO 80]  |  Consulta los objetos con un atributo denominado “myAttribute”, cuyo valor se encuentra dentro de un rango numérico (entre 75-80, ambos inclusive).  | 
|  attributes.myAttribute:\$175 TO 80]  |  Consulta los objetos con un atributo denominado “myAttribute”, cuyo valor se encuentra dentro del rango numérico (>75 y <=80).  | 
|  attributes.serialNumber:["abcd" TO "abcf"]  |  Consulta los objetos con un atributo llamado “serialNumber”, cuyo valor se encuentra dentro del rango de cadenas alfanuméricas. Esta consulta devuelve objetos con un atributo "serialNumber" con valores "abcd", "abce" o "abcf".  | 
|  attributes.myAttribute:i\$1t |  Consulta los objetos con un atributo llamado “MyAttribute” cuyo valor es 'i', seguido de un número de caracteres, seguido por 't'.  | 
|  attributes.attr1:abc AND attributes.attr2<5 NOT attributes.attr3>10  |  Consultas de objetos que combinan términos mediante expresiones booleanas. Esta consulta devuelve objetos que tengan un atributo llamado “attr1” con un valor “abc”, un atributo denominado “attr2” inferior a 5 y un atributo llamado “attr3” que no sea superior a 10.  | 
|  shadow.hasDelta:true  |  Consulta los objetos con una sombra sin nombre que tenga un elemento delta.  | 
|  NOT attributes.model:legacy  |  Consultas de objetos donde el atributo llamado "model" no es "legacy".  | 
|  shadow.reported.stats.battery:\$170 TO 100\$1 (v2 OR v3) NOT attributes.model:legacy  |  Consulta los objetos que cumplen lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot/latest/developerguide/example-queries.html)  | 
|  shadow.reported.myvalues:2  |  Consulta los objetos cuya matriz `myvalues` de la sección reported de la sombra contiene el valor 2.  | 
|  shadow.reported.location:\$1 NOT shadow.desired.stats.battery:\$1  |  Consulta los objetos que cumplen lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot/latest/developerguide/example-queries.html)  | 
|  shadow.name.<shadowName>.hasDelta:true  |  Consulta los objetos que tienen una sombra con el nombre dado y también un elemento delta.   | 
|  shadow.name.<shadowName>.desired.filament:\$1  |  Consulta los objetos que tienen una sombra con el nombre dado y también una propiedad de “filament” deseada.   | 
|  shadow.name.<shadowName>.reported.location:\$1  |  Consulta los elementos que tienen una sombra con el nombre dado y donde existe el atributo `location` en la sección de informes de la sombra con nombre.  | 
|  connectivity.connected:true  |  Consulta sobre todos los dispositivos conectados.  | 
|  connectivity.connected:false  | Consulta de todos los dispositivos desconectados. | 
|  connectivity.connected:true AND connectivity.timestamp : [1557651600000 TO 1557867600000]  | Consulta de todos los dispositivos conectados con una marca temporal de conexión >= 1557651600000 y <= 1557867600000. Las marcas temporales se indican en milisegundos desde la fecha de inicio. | 
|  connectivity.connected:false AND connectivity.timestamp : [1557651600000 TO 1557867600000]  | Consulta de todos los dispositivos desconectados con una marca temporal de desconexión >= 1557651600000 y <= 1557867600000. Las marcas temporales se indican en milisegundos desde la fecha de inicio. | 
|  connectivity.connected:true AND connectivity.timestamp > 1557651600000  | Consulta de todos los dispositivos conectados con una marca temporal de conexión > 1557651600000. Las marcas temporales se indican en milisegundos desde la fecha de inicio. | 
|  connectivity.connected:\$1  | Consulta todos los dispositivos para los que hay información de conectividad. | 
|  connectivity.disconnectReason:\$1  | Consulta todos los dispositivos con conectividad disconnectReason presentes. | 
|  connectivity.disconnectReason:CLIENT\$1INITIATED\$1DISCONNECT  | Consulta todos los dispositivos desconectados debido a CLIENT\$1INITIATED\$1DISCONNECT. | 
|  deviceDefender.violationCount:[0 TO 100]  | Consultas los objetos con un número de infracciones de Device Defender dentro del rango numérico (0-100, ambos inclusive).  | 
|  deviceDefender.<device-SecurityProfile>.disconnectBehavior.inViolation:true  | Consulta los objetos que infringen el comportamiento disconnectBehavior definido en el perfil de seguridad device-SecurityProfile. Tenga en cuenta que inViolation:false no es una consulta válida.  | 
|  deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2  | Busca elementos que infrinjan el comportamiento disconnectBehavior definido en el dispositivo del perfil de seguridad, SecurityProfile con un valor de última infracción superior a 2.  | 
|  deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000  |  Realiza consultas sobre elementos que infringen el comportamiento `disconnectBehavior` definido en el dispositivo del perfil de seguridad, SecurityProfile con un evento de última infracción transcurrido un período de tiempo especificado.   | 
|  shadow.name.gps-tracker.reported.coordinates:geo\$1distance,47.6204,-122.3491,15.5km | Consulta objetos que se encuentran dentro de una distancia radial de 15,5 km desde las coordenadas 47.6204, -122.3491. Esta cadena de consulta se aplica cuando los datos de ubicación se almacenan en una sombra con nombre. | 
|  shadow.reported.coordinates:geo\$1distance,47.6204,-122.3491,15.5km | Consulta objetos que se encuentran dentro de una distancia radial de 15,5 km desde las coordenadas 47.6204, -122.3491. Esta cadena de consulta se aplica cuando los datos de ubicación se almacenan en una sombra clásica. |