AWS IoT
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

主题:

消息代理使用主题将消息从发布客户端路由到订阅客户端。正斜杠 (/) 用于分隔主题层次结构。下表列出了订阅时可在主题筛选条件中使用的通配符。

主题通配符

通配符 描述
#

必须是您要订阅的主题中的最后一个字符。通过将当前树与所有子树相匹配来发挥通配符的作用。例如,Sensor/# 订阅将接收发布到 Sensor/Sensor/tempSensor/temp/room1 的消息,但不会接收发布到 Sensor 的消息。

+

精确匹配主题层次结构中的一个项目。例如,Sensor/+/room1 订阅将接收发布到 Sensor/temp/room1Sensor/moisture/room1 等的消息。

预留的主题

任何以 $ 开头的主题都被视为预留的主题,除非下面列出的主题之外,不支持用于进行发布和订阅。在任何其他以 $ 开头的主题中尝试发布或订阅将导致连接被终止。

主题 允许的操作 描述

$aws/events/presence/connected/clientId

Subscribe

当使用特定客户端 ID 的 MQTT 客户端连接至 AWS IoT 时,AWS IoT 将向此主题发布。有关更多信息,请参阅 连接/断开连接事件

$aws/events/presence/disconnected/clientId

Subscribe

当使用特定客户端 ID 的 MQTT 客户端与 AWS IoT 断开连接时,AWS IoT 将向此主题发布。有关更多信息,请参阅 连接/断开连接事件

$aws/events/subscriptions/subscribed/clientId

Subscribe

当使用特定客户端 ID 的 MQTT 客户端订阅 MQTT 主题时,AWS IoT 将向此主题发布。有关更多信息,请参阅 订阅/取消订阅事件

$aws/events/subscriptions/unsubscribed/clientId

Subscribe

当使用特定客户端 ID 的 MQTT 客户端取消订阅 MQTT 主题时,AWS IoT 将向此主题发布。有关更多信息,请参阅 订阅/取消订阅事件

$aws/things/thingName/shadow/delete

发布/订阅

设备或应用程序向此主题发布消息以删除影子。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#delete-pub-sub-topic

$aws/things/thingName/shadow/delete/accepted

Subscribe

当一个影子被删除时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#delete-accepted-pub-sub-topic

$aws/things/thingName/shadow/delete/rejected

Subscribe

当删除影子的请求遭拒时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#delete-rejected-pub-sub-topic

$aws/things/thingName/shadow/get

发布/订阅

应用程序或事物向此主题发布空消息来获取影子。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html

$aws/things/thingName/shadow/get/accepted

Subscribe

当获取影子的请求获批时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#get-accepted-pub-sub-topic

$aws/things/thingName/shadow/get/rejected

Subscribe

当获取影子的请求遭拒时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#get-rejected-pub-sub-topic

$aws/things/thingName/shadow/update

发布/订阅

事物或应用程序向此主题发布消息以更新影子。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#update-pub-sub-topic

$aws/things/thingName/shadow/update/accepted

Subscribe

当影子更新成功时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#update-accepted-pub-sub-topic

$aws/things/thingName/shadow/update/rejected

Subscribe

当影子更新遭拒时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#update-rejected-pub-sub-topic

$aws/things/thingName/shadow/update/delta

Subscribe

当检测到影子的“reported”部分与“desired”部分之间存在差异时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#update-delta-pub-sub-topic

$aws/things/thingName/shadow/update/documents

Subscribe

每次影子更新成功执行时,AWS IoT 都会向该主题发布状态文档。有关更多信息,请参阅 http://docs.amazonaws.cn/iot/latest/developerguide//device-shadow-mqtt.html#update-documents-pub-sub-topic

本页内容: