Ejemplo de consultas de objetos - AWS IoT Core

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

Consulta un objeto 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:

  • 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 Consulta los objetos que infrinjan el comportamiento disconnectBehavior definido en el perfil de seguridad device-SecurityProfile con un valor de último evento de infracción superior a 2.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000

Consulta los objetos que infrinjan el comportamiento disconnectBehavior definido en el perfil de seguridad device-SecurityProfile con un último evento de infracción tras un tiempo de inicio 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.