AWS IoT Device Shadow 服务

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

AWS IoT 事物对象在明确创建之前没有任何影子。可以使用 AWS IoT 控制台创建、更新和删除影子。设备、其它 Web 客户端和服务可以使用 MQTT 和预留的 MQTT 主题、使用 Device Shadow REST API 的 HTTP 以及适用于 AWS IoT 的 AWS CLI 创建、更新和删除影子。由于 AWS 将影子存储在云中，无论是否连接了设备，影子都可以从应用程序和其它云服务中收集和报告设备状态数据。

使用影子

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

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

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

如果设备经常处于离线状态，但您希望将其配置为在重新连接后接收增量消息，则可以使用持久性会话特征。有关持久性会话过期期限的更多信息，请参阅持久性会话过期期限。

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

设备影子服务支持命名的影子和未命名或经典的影子。事物对象可以具有多个命名的影子，并且最多可以具有一个未命名的影子。事物对象也可以有一个预留命名影子，它的运行方式与命名影子类似，只是您无法更新其名称。有关更多信息，请参阅预留命名影子。

事物对象可以同时具有命名和未命名的影子；不过，用于访问每种影子的 API 略有不同，因此，决定哪种类型的影子最适合您的解决方案并仅使用该类型可能更高效。有关用于访问影子的 API 的更多信息，请参阅影子主题。

通过使用命名的影子，您可以为事物对象的状态创建不同的视图。例如，您可以将一个具有很多属性的事物对象划分为具有逻辑属性组的影子，每个影子由其影子名称标识。您也可以将属性分组到不同的影子，并使用策略控制访问以限制对属性的访问。有关与设备影子配合使用的策略的更多信息，请参阅 AWS IoT 的操作、资源和条件键以及 AWS IoT Core 策略。

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

机群索引支持不同的未命名影子和命名影子。有关更多信息，请参阅管理实例集索引。

访问影子

每个影子具有预留的 MQTT 主题和 HTTP URL，该 URL 支持对影子执行 get、update 和 delete 操作。

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

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

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

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

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

消息顺序

不保证 AWS 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) 用于评估原始主题中的事物名称。有关创建规则的更多信息，请参阅AWS IoT 规则。