Exemplo de consultas de objetos - AWS IoT Core

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplo de consultas de objetos

Especifique consultas em uma string de consulta usando uma sintaxe de consulta. As consultas são passadas para a API SearchIndex. A tabela a seguir lista alguns exemplos de sequências de consulta.

String de consulta Resultado
abc

Consulta “abc” em qualquer registro, sombra (sombra clássica sem nome e sombra nomeada) ou campo de violações do Device Defender.

thingName:myThingName

Consultas sobre algo com o nome "myThingName”.

thingName:my*

Consulto objetos com nomes que começam com "my".

thingName:ab?

Consulto objetos com nomes que possuam "ab" e um caractere adicional (por exemplo: "aba", "abb", "abc" e assim por diante).

thingTypeName:aa

Consulto objetos que estejam associados ao tipo "aa".

thingGroupNames:a Consulto objetos com um grupo principal chamado "a".
thingGroupNames:a* Consulto objetos com um nome de grupo principal que corresponda ao padrão "a*".
attributes.myAttribute:75

Consulto objetos com um atributo chamado "myAttribute" que tem o valor 75.

attributes.myAttribute:[75 TO 80]

Consulto objetos com um atributo chamado "myAttribute" cujo valor esteja dentro de um intervalo numérico (75 a 80, inclusive).

attributes.myAttribute:{75 TO 80]

Consulto objetos com um atributo chamado "myAttribute" cujo valor esteja dentro do intervalo numérico (>75 e <=80).

attributes.serialNumber:["abcd" TO "abcf"]

Consulto objetos com um atributo chamado "serialNumber" cujo valor esteja dentro de um intervalo de sequência alfanumérica. Essa consulta retornará objetos com um atributo "serialNumber" com valores "abcd", "abce" ou "abcf".

attributes.myAttribute:i*t

Consulto objetos com um atributo chamado "myAttribute" em que o valor seja 'i', seguido por qualquer número de caracteres, seguido por 't'.

attributes.attr1:abc AND attributes.attr2<5 NOT attributes.attr3>10

Consulto objetos que combinam termos usando expressões boolianas. Essa consulta retorno objetos que tenham um atributo nomeado "attr1" com um valor "abc", um atributo chamado "attr2" que seja menor que 5 e um atributo chamado "attr3" que não seja maior que 10.

shadow.hasDelta:true

Consulto objetos com uma sombra sem nome que possui um elemento delta.

NOT attributes.model:legacy

Consulta de objetos em que o atributo denominado "modelo" não é "legado".

shadow.reported.stats.battery:{70 TO 100} (v2 OR v3) NOT attributes.model:legacy

Consulto objetos com o seguinte:

  • O atributo stats.battery de sombra do objeto tem um valor entre 70 e 100.

  • O texto "v2" ou "v3" ocorre em um nome de objeto, nome do tipo ou valores do atributo.

  • O atributo model do objeto não é definido como "legado".

shadow.reported.myvalues:2

Consulto objetos onde a matriz myvalues na seção relatada da sombra contém um valor igual a 2.

shadow.reported.location:* NOT shadow.desired.stats.battery:*

Consulto objetos com o seguinte:

  • O atributo location existe na seção reported da sombra.

  • O atributo stats.battery não existe na seção desired da sombra.

shadow.name.<shadowName>.hasDelta:true

Consulto objetos que tenham uma sombra com o nome fornecido e também um elemento delta.

shadow.name.<shadowName>.desired.filament:*

Consulto objetos que tenham uma sombra com o nome fornecido e também uma propriedade de filamento desejada.

shadow.name.<shadowName>.reported.location:*

Consulto objetos que tenham uma sombra com o nome fornecido e onde o atributo location exista na seção relatada da sombra nomeada.

connectivity.connected:true

Consulta todos os dispositivos conectados.

connectivity.connected:false Consulta todos os dispositivos desconectados.
connectivity.connected:true AND connectivity.timestamp : [1557651600000 TO 1557867600000] Consulta todos os dispositivos conectados com um registro de data/hora de conexão >= 1557651600000 e <= 1557867600000. Os registros de data/hora são expressos em milissegundos desde o epoch.
connectivity.connected:false AND connectivity.timestamp : [1557651600000 TO 1557867600000] Consulta todos os dispositivos desconectados com um registro de data/hora de desconexão >= 1557651600000 e <= 1557867600000. Os registros de data/hora são expressos em milissegundos desde o epoch.
connectivity.connected:true AND connectivity.timestamp > 1557651600000 Consulta todos os dispositivos conectados com um registro de data/hora de conexão > 1557651600000. Os registros de data/hora são expressos em milissegundos desde o epoch.
connectivity.connected:* Consulta todos os dispositivos com informações de conectividade presentes.
connectivity.disconnectReason:* Consulta todos os dispositivos com disconnectReason de conectividade presente.
connectivity.disconnectReason:CLIENT_INITIATED_DISCONNECT Consulta todos os dispositivos desconectados devido a CLIENT_INITIATED_DISCONNECT.
deviceDefender.violationCount:[0 TO 100] Consulto objetos com valor de contagem de violações do Device Defender que estejam dentro do intervalo numérico (0 a 100, inclusive).
deviceDefender.<device-SecurityProfile>.disconnectBehavior.inViolation:true Consulto objetos que estejam em violação do comportamento disconnectBehavior, conforme definido no perfil de segurança device-SecurityProfile. Observe que inViolation:false não é uma consulta válida.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2 Consultas sobre itens que violam o comportamento disconnectBehavior definido no dispositivo do perfil de segurança, SecurityProfile com um valor do último evento de violação maior que 2.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000

Consultas sobre itens que violam o comportamento disconnectBehavior definido no dispositivo do perfil de segurança, SecurityProfile com um último evento de violação após um período especificado.

shadow.name.gps-tracker.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Consultas sobre coisas que estão dentro da distância radial de 15,5 km das coordenadas de 47.6204, -122.3491. Essa sequência de caracteres de consulta se aplica a quando seus dados de localização são armazenados em uma sombra nomeada.
shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Consultas sobre coisas que estão dentro da distância radial de 15,5 km das coordenadas de 47.6204, -122.3491. Essa sequência de caracteres de consulta se aplica a quando seus dados de localização são armazenados em uma sombra clássica.