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\*  | Consulta los objetos cuyos nombres que comienzan por "my". | 
|  thingName:\*my  | 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:\*my\*  | 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\*  | Consulta los objetos con nombre de grupo de objetos principal o grupo de facturación que coincide con el patrón “a\*”. | 
|  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:{75 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\*t | 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:{70 TO 100} (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:\* NOT shadow.desired.stats.battery:\*  | 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:\*  | Consulta los objetos que tienen una sombra con el nombre dado y también una propiedad de “filament” deseada.  | 
|  shadow.name.<shadowName>.reported.location:\*  | 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:\*  | Consulta todos los dispositivos para los que hay información de conectividad. | 
|  connectivity.disconnectReason:\*  | Consulta todos los dispositivos con conectividad disconnectReason presentes. | 
|  connectivity.disconnectReason:CLIENT\_INITIATED\_DISCONNECT  | Consulta todos los dispositivos desconectados debido a CLIENT\_INITIATED\_DISCONNECT. | 
|  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\_distance,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\_distance,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. |