通过规则引擎的云产品流转功能,物联网平台可将指定Topic的数据,流转至其他Topic和其他阿里云产品中。本文介绍添加消息Topic作为数据源的具体操作。
背景信息
配置数据流转解析器时,需关联已添加的消息Topic,作为待流转的数据。每个数据源中最多添加1,000个消息Topic。
解析器脚本中可使用获取消息上下文的函数topic(n)
,获取消息来源的Topic。更多信息,请参见数据流转支持的函数。
创建数据源
- 登录物联网平台控制台。
在实例概览页签的全部环境下,找到对应的实例,单击实例卡片。
- 在左侧导航栏,选择 。
在云产品流转页面,单击右上角体验新版,进入新版功能页面。
说明如果您已执行过此操作,再次进入云产品流转页面,会直接进入新版功能页面。
单击数据源页签,然后单击创建数据源。
输入数据源名称和描述,单击确定。
数据源名称支持中文、英文字母、日文、数字、下划线(_)和短划线(-),长度为1~30个字符,一个中文及日文占2个字符。
根据页面提示,可直接进入数据源详情页面。您可单击右上角编辑,修改数据源名称和描述。
在数据源详情页面,单击添加Topic,在弹出对话框中,根据页面提示,选择需要处理的消息Topic,然后单击确定。
支持的Topic如下:
重要对于云网关产品和设备,仅支持选择自定义、设备状态变化通知和设备生命周期变更。消息转发Topic和数据格式的详情说明,请参见开源MQTT协议的消息通信说明、JT/T 808协议的消息转发说明、GB/T 32960协议的消息转发说明。
表 1. Topic说明 Topic
说明
相关文档
自定义
流转自定义数据格式消息的Topic,与自定义Topic的格式相同。格式为:
/${productKey}/${deviceName}/user/${TopicShortName}
。其中
${TopicShortName}
为自定义的Topic类,即自定义Topic的后缀。支持使用通配符(+)和(#):
全部设备(
+
):指定产品下所有设备。/user/#
:指定设备的所有自定义Topic。
设备状态变化通知
流转设备上下线状态变更消息的Topic:
/as/mqtt/status/${productKey}/${deviceName}
。物模型数据上报
包含:
流转设备上报属性数据的Topic:
/${productKey}/${deviceName}/thing/event/property/post
。流转设备上报事件数据的Topic:
/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post
。流转设备批量上报属性数据的Topic:
/${productKey}/${deviceName}/thing/property/batch/post
。流转设备批量上报事件数据的Topic:
/${productKey}/${deviceName}/thing/event/batch/post
。流转设备响应云端命令返回消息的Topic:
/${productKey}/${deviceName}/thing/downlink/reply/message
。
对应设备上报原始数据的Topic如下:
设备上报属性的Topic:
/sys/${productKey}/${deviceName}/thing/event/property/post
。设备上报事件的Topic:
/sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post
、/sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:{tsl.event.identifier}/post
。设备批量上报属性、事件数据的Topic:
/sys/${productKey}/${deviceName}/thing/event/property/batch/post
。
设备生命周期变更
流转设备创建、删除、禁用、启用等消息的Topic:
/${productKey}/${deviceName}/thing/lifecycle
。网关发现子设备上报
网关设备特有的Topic:
/${productKey}/${deviceName}/thing/list/found
,将发现的子设备信息上报给物联网平台,然后进行流转。设备拓扑关系变更
网关设备特有Topic:
/${productKey}/${deviceName}/thing/topo/lifecycle
,流转子设备和网关之间的拓扑关系建立和解除消息的Topic。对应设备上报原始数据的Topic:
/sys/${productKey}/${deviceName}/thing/topo/change
。设备标签变更
流转设备标签信息变更的Topic:
/${productKey}/${deviceName}/thing/deviceinfo/update
。对应设备上报原始数据的Topic:
/sys/${productKey}/${deviceName}/thing/deviceinfo/update
。物模型历史数据上报
包含:
流转设备上报历史属性数据的Topic:
/${productKey}/${deviceName}/thing/event/property/history/post
。流转设备上报历史事件数据的Topic:
/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/history/post
。
对应设备上报物模型历史数据的Topic:
/sys/${productKey}/${deviceName}/thing/event/property/history/post
。OTA升级设备状态通知
包含:
流转设备上报OTA升级结果的Topic:
/${productKey}/${deviceName}/ota/upgrade
。流转设备上报OTA升级进度的Topic:
/${productKey}/${deviceName}/ota/progress/post
。
对应设备上报升级进度的Topic:
/ota/device/progress/${productKey}/${deviceName}
。OTA模块版本号上报
流转设备上报OTA模块版本号变更的Topic:
/${productKey}/${deviceName}/ota/version/post
。对应设备上报OTA模块版本的Topic:
/ota/device/inform/${productKey}/${deviceName}
。OTA升级批次状态通知
物联网平台通知OTA升级批次状态变化的Topic:
/${productKey}/${packageId}/${jobId}/ota/job/status
。任务事件
流转实例迁移任务状态通知的Topic:
/sys/uid/${uid}/distribution/${jobId}/lifecycle
。说明迁移产品的名称为实例迁移的任务名称。
可选:重复上一步操作,可在当前数据源下,添加多个消息Topic。
添加Topic后,若有业务需求,您也可在数据源详情页面,删除已添加的消息Topic。