Ejemplo de consultas de objetos - AWS IoT Core

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

Especifique las consultas en una cadena de consulta mediante una sintaxis de consulta. Las consultas se pasan a la API SearchIndex. 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

Consultas para algo con el nombre «myThingName».
thingName:my*

Consulta los objetos cuyos nombres que comienzan por "my".
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 “a”.
thingGroupNames:a* Consulta los objetos con nombre de grupo de objetos principal 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:

  • El atributo stats.battery de sombra del objeto tiene un valor entre 70 y 100.

  • El texto "v2" o "v3" aparece en los valores del atributo, el nombre del tipo o el nombre del objeto.

  • El atributo model del objeto no está establecido en "legacy".
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:

  • El atributo location existe en la sección reported de la sombra.

  • El atributo stats.battery no existe en la sección desired de la sombra.
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 elementos 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 elementos 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.