事物查询示例 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

事物查询示例

注意

机群索引功能在预览版中 Amazon IoT Device Defender 支持名为影子和 Amazon IoT Device Management 违规数据本文档,随时可能更改。

使用查询语法在查询字符串中指定查询。查询将传递给SearchIndexAPI。下表列出了一些查询字符串示例。

查询字符串 结果

abc

在任何注册表、影子(经典未命名影子和命名影子)或 Device Defender 违规字段中查询“abc”。

thingName:myThingName

查询名为“myThingName”的事物。

thingName:my*

查询名称以“my”开头的事物。

thingName:ab?

查询名称为“ab”加另外一个字符的事物(例如:“aba”、“abb”、“abc”等)。

thingTypeName:aa

查询与类型 aa 关联的事物。

attributes.myAttribute:75

查询属性名为“myAttribute”且属性值为 75 的事物。

attributes.myAttribute:[75 TO 80]

查询属性名为“myAttribute”,且属性值在数字范围(75-80,含 75 和 80)之内的事物。

attributes.myAttribute:{75 TO 80]

查询属性名为“myAttribute”,且属性值在数字范围(大于 75 且小于等于 80)之内的事物。

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

查询属性名为“serialNumber”,且属性值在字母数字字符串范围之内的事物。此查询将返回属性名为“serialNumber”,且其值为“abcd”、“abce”或“abcf”的事物。

attributes.myAttribute:i*t

查询属性名为“myAttribute”,且属性值为以“i”开头、以“t”结尾、中间有任意数量字符的事物。

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

使用布尔表达式组合术语来查询事物。此查询将返回具有下列特征的事物:属性名为“attr1”且值为“abc”;属性名为“attr2”且值小于 5;以及属性名为“attr3”且值不大于 10。

shadow.hasDelta:true

查询具有增量元素的未命名影子的事物。

NOT attributes.model:legacy

查询属性名为“model”且不是“legacy”的事物。

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

查询具有以下特征的事物:

  • 事物的影子 stats.battery 属性具有介于 70 到 100 之间的值。

  • 文本“v2”或“v3”出现在事物的名称、类型名称或属性值中。

  • 事物的 model 属性未设置为“legacy”。

shadow.reported.myvalues:2

查询具有以下特征的事物:影子的“reported”部分中的 myvalues 数组包含值 2。

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

查询具有以下特征的事物:

  • 影子的 location 部分中存在 reported 属性。

  • 影子的 desired 部分中不存在 stats.battery 属性。

shadow.name.<shadowName>.hasDelta:true

查询具有给定名称和增量元素影子的东西。用于支持名为影子的索引的机群组索引功能位于 Amazon IoT Device Management 的预览版本中。

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

查询具有给定名称和所需灯丝特性的阴影的对象。支持索引命名影子的机群索引功能已在 Amazon IoT Device Management 预览版中。

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

查询具有具有给定命名影子且 location 属性存在于命名影子的报告部分中的事物。支持索引命名影子的机群索引功能已在 Amazon IoT Device Management 预览版中。

connectivity.connected:true

查询所有连接的设备。

connectivity.connected:false

查询所有断开连接的设备。

connectivity.connected:true AND connectivity.timestamp : [1557651600000 TO 1557867600000]

查询所有已连接且连接时间戳 >= 1557651600000 且 <= 1557867600000 的设备。时间戳以自纪元以来的毫秒数给出。

connectivity.connected:false AND connectivity.timestamp : [1557651600000 TO 1557867600000]

查询所有已断开连接且断开连接时间戳 >= 1557651600000 且 <= 1557867600000 的设备。时间戳以自纪元以来的毫秒数给出。

connectivity.connected:true AND connectivity.timestamp > 1557651600000

查询所有已连接且连接时间戳 > 1557651600000 的设备。时间戳以自纪元以来的毫秒数给出。

connectivity.connected:*

查询具有连接信息的所有设备。

connectivity.disconnectReason:*

查询具有连接断开原因的所有设备。

connectivity.disconnectReason:CLIENT_INITIATED_DISCONNECT

查询由于 CLIENT_INITATE_DISKINATE_DISKINTION 而断开的所有设备

deviceDefender.violationCount:[0 TO 100]

查询设备计数值在数字范围(0-100)内的 Device Defender 违规事物。支持索引 Device Defender 违规数据的机群索引功能在 Amazon IoT Device Management 预览版中。

deviceDefender.<device-SecurityProfile>.disconnectBehavior.inViolation:true

查询违反安全配置文件 device-SecurityProfile 中定义的行为 disconnectBehavior 的事物。请注意,inViolation:false 不是有效的查询。支持索引 Device Defender 违规数据的机群索引功能在 Amazon IoT Device Management 预览版中。

deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2

查询上次违规事件值大于 2 的安全配置文件设备 SecurityProfile 中定义的行为 disconnectBehavior 违规事物。支持索引 Device Defender 违规数据的机群索引功能在 Amazon IoT Device Management 预览版中。

deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000

查询上次违规事件特定纪元时间后的安全配置文件设备 SecurityProfile 中定义的行为 disconnectBehavior 违规事物。支持索引 Device Defender 违规数据的机群索引功能在 Amazon IoT Device Management 预览版中。