# Topic定义
设备使用MQTT协议接入平台时，平台和设备通过Topic进行通信。平台预置的topic列表如下：
| Topic分类                                                                                    | Topic                                                                       | Publisher(发布者) | Subscriber(订阅者) | 用途                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|:---|
| 设备消息相关Topic  | $oc/devices/{device_id}/sys/messages/up                                     | 设备             | 平台              | [设备消息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3016.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 设备消息相关Topic  | $oc/devices/{device_id}/sys/messages/down                                   | 平台             | 设备              | [平台消息下发](https://support.huaweicloud.com/api-iothub/iot_06_v5_3017.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 设备命令相关Topic                                                                                | $oc/devices/{device_id}/sys/commands/request_id={request_id}                | 平台             | 设备              | [平台命令下发](https://support.huaweicloud.com/api-iothub/iot_06_v5_3014.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 设备命令相关Topic                                                                                | $oc/devices/{device_id}/sys/commands/response/request_id={request_id}       | 设备             | 平台              | [设备返回命令响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_3014.html#ZH-CN_TOPIC_0000001426695400__zh-cn_topic_0208194431_section98871406444)                                                                                                                                                                                                                                                                                                                                                                                            |
| 设备属性相关Topic                                                                                | $oc/devices/{device_id}/sys/properties/report                               | 设备             | 平台              | [设备属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3010.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 设备属性相关Topic                                                                                | $oc/devices/{device_id}/sys/gateway/sub_devices/properties/report           | 设备             | 平台              | [网关批量设备属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3006.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 设备属性相关Topic                                                                                | $oc/devices/{device_id}/sys/properties/set/request_id={request_id}          | 平台             | 设备              | [平台设置设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_3008.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 设备属性相关Topic                                                                                | $oc/devices/{device_id}/sys/properties/set/response/request_id={request_id} | 设备             | 平台              | [属性设置的响应结果](https://support.huaweicloud.com/api-iothub/iot_06_v5_3008.html#ZH-CN_TOPIC_0000001476455145__zh-cn_topic_0208194429_section98871406444)                                                                                                                                                                                                                                                                                                                                                                                           |
| 设备属性相关Topic                                                                                | $oc/devices/{device_id}/sys/properties/get/request_id={request_id}          | 平台             | 设备              | [平台查询设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_3011.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 设备属性相关Topic                                                                                | $oc/devices/{device_id}/sys/properties/get/response/request_id={request_id} | 设备             | 平台              | [属性查询响应结果](https://support.huaweicloud.com/api-iothub/iot_06_v5_3011.html#ZH-CN_TOPIC_0000001476614913__zh-cn_topic_0208194430_section98871406444)                                                                                                                                                                                                                                                                                                                                                                                            |
| 设备属性相关Topic                                                                                | $oc/devices/{device_id}/sys/shadow/get/request_id={request_id}              | 设备             | 平台              | [设备侧获取平台的设备影子数据](https://support.huaweicloud.com/api-iothub/iot_06_v5_3012.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 设备属性相关Topic                                                                                | $oc/devices/{device_id}/sys/shadow/get/response/request_id={request_id}     | 平台             | 设备              | [设备侧主动获取平台设备影子数据的响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_3012.html#ZH-CN_TOPIC_0000001426536156__zh-cn_topic_0208194428_section98871406444)                                                                                                                                                                                                                                                                                                                                                                                  |
| 设备事件相关Topic                                                                                | $oc/devices/{device_id}/sys/events/up                                       | 设备             | 平台              | 设备事件上报与平台事件下发，可用于：[网关与子设备管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_3018.html)、[软固件升级](https://support.huaweicloud.com/api-iothub/iot_06_v5_3027.html)、[文件上传/下载管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_3032.html)、[设备时间同步](https://support.huaweicloud.com/api-iothub/iot_06_v5_3039.html)、[设备信息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_30403.html)、[设备日志收集](https://support.huaweicloud.com/api-iothub/iot_06_v5_1301.html)、[远程配置](https://support.huaweicloud.com/api-iothub/iot_0801.html) |
| 设备事件相关Topic                                                                                | $oc/devices/{device_id}/sys/events/down                                     | 平台             | 设备              | 设备事件上报与平台事件下发，可用于：[网关与子设备管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_3018.html)、[软固件升级](https://support.huaweicloud.com/api-iothub/iot_06_v5_3027.html)、[文件上传/下载管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_3032.html)、[设备时间同步](https://support.huaweicloud.com/api-iothub/iot_06_v5_3039.html)、[设备信息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_30403.html)、[设备日志收集](https://support.huaweicloud.com/api-iothub/iot_06_v5_1301.html)、[远程配置](https://support.huaweicloud.com/api-iothub/iot_0801.html) |
   
![](https://support.huaweicloud.com/api-iothub/public_sys-resources/note_3.0-zh-cn.png)
- {device_id}用于标识Topic路由的目标设备，设备侧订阅该topic或往topic推送消息时，该值需要替换为设备与平台建立MQTT连接时使用的设备ID参数值。
- {request_id}用于唯一标识这次请求。设备侧发起的消息带该参数时，需要保证设备侧该参数值的唯一性，可以用递增的数字或者UUID来实现。当设备收到平台下发的topic中包含request_id时，设备侧响应的request_id需要跟平台下发的保持一致。
- 设备侧订阅带{request_id}参数的topic时，可以使用通配#。如设备侧订阅命令下发请求的topic $oc/devices/{device_id}/sys/commands/request_id={request_id}时，可以用$oc/devices/{device_id}/sys/commands/#。
- 平台采用了隐式订阅的功能，对于下行的系统topic，设备无需订阅，平台默认该设备订阅了qos为0的系统topic。如果需要qos为1的下行系统topic，需要设备自行订阅。
- 除了device_id、request_id其他均为系统字段。