通過規則引擎的雲產品流轉功能,物聯網平台可將指定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}/job/${jobId}/lifecycle
。流轉執行個體遷移任務狀態通知的Topic:
/sys/uid/${uid}/distribution/${jobId}/lifecycle
。說明遷移產品的名稱為執行個體遷移的任務名稱。
可選:重複上一步操作,可在當前資料來源下,添加多個訊息Topic。
添加Topic後,若有業務需求,您也可在資料來源詳情頁面,刪除已添加的訊息Topic。