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

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon IoT Device Shadow 服务

Amazon IoT Device Shadow 服务在 Amazon IoT 事物对象中添加影子。无论设备是否连接到 Amazon IoT,影子都可以向应用程序和其他服务提供设备的状态。Amazon IoT 事物对象可以具有多个命名的影子,以便 IoT 解决方案具有更多选项以将设备连接到其他应用程序和服务。

在明确创建之前,Amazon IoT 事物对象没有任何命名的影子;不过,在创建事物时,将会为其创建未命名的经典影子。可以使用 Amazon IoT 控制台创建、更新和删除影子。设备、其他 Web 客户端和服务可以使用 MQTT 和保留的 MQTT 主题,HTTP 使用Device Shadow REST API,以及Amazon CLI对于 来说为Amazon IoT。因为阴影是由Amazon,无论设备是否连接了应用程序和其他云服务,他们都可以从应用程序和其他云服务中收集和报告设备状态数据。

使用影子

影子为设备、应用程序和其他云服务提供可靠的数据存储以共享数据。它们允许设备、应用程序和其他云服务连接和断开连接,而不会丢失设备的状态。

在设备、应用程序和其他云服务连接到 Amazon IoT 后,它们可以通过设备影子访问和控制设备的当前状态。例如,应用程序可以更新影子以请求更改设备的状态。Amazon IoT 发布一条消息以指示对设备所做的更改。设备接收该消息,更新其状态以保持匹配,然后发布一条消息以指示其更新状态。Device Shadow 服务在相应的影子中反映该更新状态。应用程序可以订阅影子的更新,也可以查询影子以获取其当前状态。

在设备脱机时,应用程序仍然可以与 Amazon IoT 和设备的影子进行通信。在设备重新连接时,它接收其影子的当前状态,以便它可以更新其状态以与其影子的状态匹配,然后发布一条消息以指示其更新状态。同样,如果应用程序脱机并且设备状态在其脱机时发生变化,则设备将影子保持更新状态,以便应用程序可以在设备重新连接时查询影子以获取其当前状态。

选择使用命名或未命名的影子

Device Shadow 服务支持命名的影子和未命名的经典影子,与过去使用的一样。事物对象可以具有多个命名的影子,并且最多可以具有一个未命名的经典影子。事物对象可以同时具有命名和未命名的影子;不过,用于访问每种影子的 API 略有不同,因此,决定哪种类型的影子最适合您的解决方案并仅使用该类型可能更高效。有关用于访问影子的 API 的更多信息,请参阅影子主题

通过使用命名的影子,您可以为事物对象的状态创建不同的视图。例如,您可以将一个具有很多属性的事物对象划分为具有逻辑属性组的影子,每个影子由其影子名称标识。您也可以将属性分组到不同的影子,并使用策略控制访问以限制对属性的访问。但是,命名阴影不支持队列索引

经典的未命名影子比命名的影子更简单,但在某些程度上比命名的影子更受限制。每个 Amazon IoT 事物对象只能具有一个未命名的影子。如果预计您的 IoT 解决方案对影子数据的需求有限,您可能希望以这种方式开始使用影子。不过,如果您认为将来可能要添加其他影子,请考虑从一开始就使用命名的影子。

访问影子

每个影子具有保留的 MQTT 主题HTTP URL,该 URL 支持对影子执行 getupdatedelete 操作。

影子使用 JSON 影子文档以存储和检索数据。影子的文档包含一个状态属性,以描述设备状态的以下方面:

  • desired

    应用程序更新 desired 对象以指定设备属性的所需状态。

  • reported

    设备在 reported 对象中报告其当前状态。

  • delta

    Amazon IoT 在 delta 对象中报告所需的状态和报告的状态之间的差异。

存储在影子中的数据是由更新操作的消息正文的状态属性确定的。后续的更新操作可以修改现有数据对象的值,也可以在影子的状态对象中添加和删除键和其他元素。有关访问影子的更多信息,请参阅在设备中使用影子在应用程序和服务中使用影子

重要

发出更新请求的权限应限制为受信任的应用程序和设备。这可防止意外更改影子的状态属性;否则,使用影子的设备和应用程序应设计为需要更改状态属性中的键。

在设备、应用程序和其他云服务中使用影子

要在设备、应用程序和其他云服务中使用影子,需要在它们之间保持一致性和协调性。Amazon IoT Device Shadow 服务存储影子状态,在影子状态发生变化时发送消息,以及响应指示更改了其状态的消息。您的 IoT 解决方案中的设备、应用程序和其他云服务必须管理其状态,并使其与设备影子的状态保持一致。

影子状态数据是动态的,有权访问影子的设备、应用程序和其他云服务可以对其进行更改。因此,请务必考虑每个设备、应用程序和其他云服务如何与影子进行交互。例如:

  • 在将状态数据传送到影子时,设备 应仅写入到影子状态的 reported 属性中。

  • 在通过影子将状态更改请求传送到设备时,应用程序和其他云服务 应仅写入到 desired 属性中。

重要

影子数据对象中包含的数据与其他影子和其他事物对象属性的数据(例如事物的属性以及事物对象的设备可能发布的 MQTT 消息内容)无关。不过,如果需要,设备可以在不同的 MQTT 主题和影子中报告相同的数据。

支持多个影子的设备必须将它在不同影子中报告的数据保持一致。

消息顺序

不保证 Amazon IoT 服务发送的消息按任何特定顺序到达设备。以下方案显示了此时发生的情况。

初始状态文档:

{ "state": { "reported": { "color": "blue" } }, "version": 9, "timestamp": 123456776 }

更新 1:

{ "state": { "desired": { "color": "RED" } }, "version": 10, "timestamp": 123456777 }

更新 2:

{ "state": { "desired": { "color": "GREEN" } }, "version": 11, "timestamp": 123456778 }

最终状态文档:

{ "state": { "reported": { "color": "GREEN" } }, "version": 12, "timestamp": 123456779 }

这将产生两个增量消息:

{ "state": { "color": "RED" }, "version": 11, "timestamp": 123456778 }
{ "state": { "color": "GREEN" }, "version": 12, "timestamp": 123456779 }

设备可能不会按次序收到这些消息。由于这些消息中的状态是累计的,设备可以安全地弃用版本号比正在追踪的版本号更早的所有消息。如果设备在接收版本 11 的增量之前收到版本 12 的增量,则可以安全地弃用版本 11 的消息。

修剪影子消息

要降低发送到您的设备的影子消息的大小,请定义一项规则,以仅选择设备所需的字段然后将消息重新发布到设备正在侦听的 MQTT 主题。

规则应在 JSON 中指定,且应与以下内容类似:

{ "sql": "SELECT state, version FROM '$aws/things/+/shadow/update/delta'", "ruleDisabled": false, "actions": [ { "republish": { "topic": "${topic(3)}/delta", "roleArn": "arn:aws:iam:123456789012:role/my-iot-role" } } ] }

SELECT 语句用于确定将消息中的哪些字段重新发布到指定的主题。“+”通配符用于匹配所有影子名称。该规则指定,应将所有匹配的消息重新发布到指定的主题。在此情况下,可以使用 "topic()" 函数指定将消息重新发布到哪个主题。topic(3) 用于评估原始主题中的事物名称。有关创建规则的更多信息,请参阅Amazon IoT 规则