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

主题

消息代理使用主题将消息从发布客户端路由到订阅客户端。主题是 UTF-8 编码的分层字符串。正斜杠 (/) 用于分隔主题层次结构中的级别。例如:

Sensor/temperature/room1

该主题引用房间 1 中的温度传感器。

注意

请勿在主题中使用个人身份信息。

下表列出了订阅时可在主题筛选条件中使用的通配符。

主题通配符

通配符 描述
#

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

+

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

每个 AWS 账户和区域对的主题命名空间均是独立的。例如,AWS 账户的 Sensor/temp/room1 主题独立于另一 AWS 账户的 Sensor/temp/room1 主题。在区域方面,情况同样如此。Sensor/temp/room1 内同一 AWS 账户中的 us-east-1 主题独立于 us-west-2 内的同一主题。AWS IoT 不支持跨 AWS 账户和区域发送和接收消息。

预留的主题

除了此处列出的主题,任何以 $ 开头的主题都被视为预留的主题,不支持用于进行发布和订阅。任何尝试发布或订阅以 $ 开头的主题都将导致连接被终止。

事件主题

主题 允许的操作 描述

$aws/events/presence/connected/clientId

订阅

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

$aws/events/presence/disconnected/clientId

订阅

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

$aws/events/subscriptions/subscribed/clientId

订阅

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

$aws/events/subscriptions/unsubscribed/clientId

订阅

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

规则主题

主题 允许的操作 描述

$aws/rules/ruleName

发布

设备或应用程序向此主题发布消息以直接触发规则。有关更多信息,请参阅 基本摄取

事物影子主题

主题 允许的操作 描述

$aws/things/<thingName>/shadow/delete

发布/订阅

设备或应用程序向此主题发布消息以删除影子。有关更多信息,请参阅 /delete

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

订阅

当一个影子被删除时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 /delete/accepted

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

订阅

当删除影子的请求遭拒时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 /delete/rejected

$aws/things/<thingName>/shadow/get

发布/订阅

应用程序或事物向此主题发布空消息来获取影子。有关更多信息,请参阅影子 MQTT 主题

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

订阅

当获取影子的请求获批时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 /get/accepted

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

订阅

当获取影子的请求遭拒时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 /get/rejected

$aws/things/<thingName>/shadow/update

发布/订阅

事物或应用程序向此主题发布消息以更新影子。有关更多信息,请参阅 /update

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

订阅

当影子更新成功时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 /update/accepted

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

订阅

当影子更新遭拒时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 /update/rejected

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

订阅

当检测到影子的“reported”部分与“desired”部分之间存在差异时,Device Shadow 服务将向此主题发送消息。有关更多信息,请参阅 /update/delta

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

订阅

每次影子更新成功执行时,AWS IoT 都会向该主题发布状态文档。有关更多信息,请参阅 /update/documents

作业主题

主题 允许的操作 描述

$aws/things/<thingName>/jobs/get

发布

设备向此主题发布一条消息以发出 GetPendingJobExecutions 请求。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/get/accepted

订阅

设备订阅此主题以接收来自 GetPendingJobExecutions 请求的成功响应。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/get/accepted

订阅

设备订阅此主题以接收 GetPendingJobExecutions 请求的成功响应。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/start-next

发布

设备向此主题发布一条消息以发出 StartNextPendingJobExecution 请求。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/start-next/accepted

订阅

设备订阅此主题以接收 StartNextPendingJobExecution 请求的成功响应。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/start-next/rejected

订阅

设备订阅此主题以接收 StartNextPendingJobExecution 请求的成功响应。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/jobId/get

发布

设备向此主题发布一条消息以发出 DescribeJobExecution 请求。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/<jobId>/get/accepted

订阅

设备订阅此主题以接收 DescribeJobExecution 请求的成功响应。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/<jobId>/get/rejected

订阅

设备订阅此主题以接收 DescribeJobExecution 请求的成功响应。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/<jobId>/update

发布

设备向此主题发布一条消息以发出 UpdateJobExecution 请求。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/<jobId>/update/accepted

订阅

设备订阅此主题以接收 UpdateJobExecution 请求的成功响应。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/<jobId>/update/rejected

订阅

设备订阅此主题以接收 UpdateJobExecution 请求的成功响应。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/notify

订阅

设备订阅此主题,以在某个事务的待处理执行列表中添加或删除了作业执行时接收通知。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/things/<thingName>/jobs/notify-next

订阅

设备订阅此主题,以在事务的下一个待处理作业执行发生更改时接收通知。有关更多信息,请参阅使用 AWS IoT 作业 API

$aws/events/job/<jobId>/completed

订阅

当某个作业完成时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/job/<jobId>/canceled

订阅

当取消某个作业时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/job/<jobId>/deleted

订阅

当删除某个作业时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/job/<jobId>/cancellation_in_progress

订阅

当开始取消某个作业时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/job/<jobId>/deletion_in_progress

订阅

当开始删除某个作业时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/jobExecution/<jobId>/succeeded

订阅

当作业执行成功时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/jobExecution/<jobId>/failed

订阅

当作业执行失败时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/jobExecution/<jobId>/rejected

订阅

当作业执行被拒绝时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/jobExecution/<jobId>/canceled

订阅

当作业执行取消时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/jobExecution/<jobId>/timed_out

订阅

当作业执行超时时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/jobExecution/<jobId>/removed

订阅

当作业执行被移除时,作业服务在此主题上发布事件。有关更多信息,请参阅作业事件

$aws/events/jobExecution/<jobId>/deleted

订阅

当作业执行被删除时,作业服务在此主题上发布事件。有关更多信息,请参阅:作业事件

本页内容: