MQTT

• 持久性会话到期时间已过。当消息代理检测到客户端已断开连接（通过客户端断开连接或连接超时）时，持久性会话到期计时器将启动。

• 当客户端发送将 cleanSession 标记设置为 1 的 CONNECT 消息时。

使用 MQTT 保留消息的示例

• 作为初始配置消息

  客户端订阅主题后，MQTT 保留消息会被发送给客户端。如果希望订阅主题的所有客户端在订阅后立即接收 MQTT 保留消息，您可以发布设置了RETAIN 标志的配置消息。只要发布新的配置消息，订阅客户端也会收到该配置更新。

• 作为最后一个已知的状态消息

  设备可以在当前状态消息上设置 REATIN 标志，以便 Amazon IoT Core 保存它们。当应用程序连接或重新连接时，它们可以订阅此主题并在订阅保留消息主题后立即获得上一次报告状态。这样，它们就不必等到设备发出下一条消息才能看到当前状态。

• 创建保留消息

  客户端在发布 MQTT 消息时确定是否保留消息。客户端可以在发布消息时使用 设备 SDK 设置 RETAIN 标志。应用程序和服务可以在使用 Publish 操作 发布 MQTT 消息时设置 RETAIN 标志。

  每个主题名称只保留一条消息。发布到主题的带有 RETAIN 标志设置的新消息将替换先前发送到该主题的任何现有保留消息。

  注意： 如果您设置了 RETAIN 标志则不能发布到 预留主题。

• 订阅保留消息主题

  客户端订阅保留消息主题，就像订阅任何其他 MQTT 消息主题一样。通过订阅保留消息主题接收的保留消息均有 RETAIN 标志设置。

  当客户端将具有 0 字节消息负载的保留消息发布到保留消息主题时，将从 Amazon IoT Core 中删除保留消息。已订阅保留消息主题的客户端也将收到该 0 字节消息。

  订阅包含保留消息主题的通配符主题筛选条件可使客户端接收发布到保留消息主题的后续消息，但在订阅时不会传递保留消息。

  注意： 要在订阅时接收保留消息，订阅请求中的主题筛选条件必须与保留消息主题完全匹配。

  订阅保留消息主题时收到的保留消息有 RETAIN 标志设置。订阅客户端在订阅后收到的保留消息则没有。

• 检索保留消息

  当客户端使用保留消息订阅主题时，保留消息会被自动发送给客户端。要让客户端在订阅时收到保留消息，必须订阅保留消息的确切主题名称。通过订阅包含保留消息主题的通配符主题筛选条件，客户端可以接收发布到保留消息主题的后续消息，但不会在订阅时传送保留消息。

  服务和应用可以通过调用 ListRetainedMessages 和 GetRetainedMessage 列出和检索保留消息。

  在 未 设置 RETAIN 标志的情况下，客户端不会被阻止发布消息到保留消息主题。这可能会导致意外结果，例如保留消息与订阅主题收到的消息不匹配。

• 列出保留消息主题

  您可以通过调用 ListRetainedMessages 列出保留消息，并且可以在 Amazon IoT 控制台 中查看保留消息。

• 获取保留消息详细信息

  您可以通过调用 GetRetainedMessage 获取保留消息的详细信息，并且可以在 Amazon IoT 控制台 中查看这些信息。

• 保留 Will 消息

  连接设备时创建的 MQTT Will 消息 可以通过设置 Connect Flag bits 字段中的 Will Retain 标记保留。

• 删除保留消息

  通过将设置了 RETAIN 标志的消息和空（0字节）消息负载发布到要删除的保留消息的主题名称，设备、应用程序和服务可以删除保留消息。从 Amazon IoT Core 中删除保留消息的此类消息被发送给订阅了该主题的客户端，但 Amazon IoT Core 不会保留此类消息。

  还可以通过访问 Amazon IoT 控制台 中的保留消息以交互的方式删除保留消息。通过 Amazon IoT 控制台 删除的保留消息也会向已订阅保留消息主题的客户端发送 0 字节的消息。

  保留消息在删除后无法恢复。客户端需要发布新的保留消息才能取代已删除的消息。

• 保留消息的调试和故障排查

  Amazon IoT 控制台 提供多个工具来帮助您进行保留消息故障排查：

  • 保留消息 页面

    Amazon IoT 控制台中的 保留消息 页面提供您的账户在当前区域中存储的保留消息的分页列表。在此页面上，您可以：

    • 查看每条保留消息的详细信息，例如消息负载、QoS、接收时间。

    • 更新保留消息的内容。

    • 删除保留消息。

  • 打开 MQTT 测试客户端

    Amazon IoT 控制台中的 MQTT 测试客户端 页面可以订阅并发布到 MQTT 主题。发布选项让您可以在发布的消息上设置 REATEIN 标志，以模拟设备的行为方式。

  在 Amazon IoT Core 中如何应用保留消息的这些方面可能会产生一些意外的结果。

  • 保留消息限制

    当帐户存储了最大数量的保留消息时，对于使用 RETAIN 设置且有效负载大于 0 字节的发布消息，Amazon IoT Core 将返回限制响应，直到一些保留消息被删除且保留消息数量低于限制。

  • 保留消息传递顺序

    不保证保留消息和订阅消息传递的顺序。

• Amazon IoT 仅支持 MQTT 服务质量 (QoS) 级别 0 和 1。Amazon IoT 不支持使用 QoS 级别 2 进行发布或订阅。在请求 QoS 级别 2 时，消息代理不会发送 PUBACK 或 SUBACK。

• 在 Amazon IoT 中，订阅具有 QoS 级别 0 的主题意味着将消息传送零次或多次。消息可能会多次发送。多次发送的消息在发送时可能会使用不同的数据包 ID。在这些情况下，不会设置 DUP 标志。

• 在响应连接请求时，消息代理将发送 CONNACK 消息。此消息包含一个标志，用于指明该连接是否会恢复上一个会话。

• 在发送其它控制数据包或断开连接请求之前，客户端必须等待从 Amazon IoT 消息代理发送到设备的 CONNACK 消息。

• 当由于客户端未被授权进行连接而拒绝连接时，Amazon IoT 会返回错误代码 7，而不是 CONNACK 错误代码 5。

• 当客户端订阅主题时，在消息代理开始发送 SUBACK 和客户端开始收到新的匹配消息之间存在时间延迟。

• 当客户端在订阅主题的主题过滤条件中使用通配符 # 时，主题层次结构中处于及其级别以下的所有字符串均会匹配。但是，父主题不匹配。例如，订阅主题 sensor/# 接收发布到主题sensor/、sensor/temperature、sensor/temperature/room1 的消息，但不是发布到 sensor 的消息。有关通配符的更多信息，请参阅 主题筛选条件。

• 消息代理使用客户端 ID 标识每个客户。客户端 ID 作为 MQTT 负载的一部分从客户端传递到消息代理。客户端 ID 相同的两个客户端无法同时连接到消息代理。当某个客户端使用另一客户端正在使用的客户端 ID 连接到消息代理时，会接受新的客户端连接，而之前连接的客户端会断开连接。

• 在极少数情况下，消息代理可能会使用不同的数据包 ID 再次发送相同的逻辑 PUBLISH 消息。

• 订阅包含通配符的主题筛选条件无法接收保留消息。要接收保留消息，订阅请求必须包含与保留消息主题完全匹配的主题筛选条件。

• 消息代理并不保证收到消息和 ACK 的顺序。

• 每个发布请求的有效负载不能大于 128 KB。Amazon IoT Core 拒绝大于此大小的发布和连接请求。有关更多信息，请参阅《Amazon IoT 参考指南》中的Amazon IoT Core消息代理和协议限制与限额。