全部產品
Search
文件中心

IoT Platform:遷移後功能使用說明

更新時間:Jun 30, 2024

本文介紹公用執行個體下產品和裝置遷移到企業版執行個體後,各功能使用說明。

背景資訊

執行個體遷移的詳細說明,請參見使用前必讀

物聯網平台產品功能的詳細說明,請參見功能特性

裝置接入

功能

說明

裝置端SDK

裝置端自動連接到企業版執行個體,無需修改。

裝置安全認證

支援一機一密和一型一密預註冊認證方式。

NB-IoT裝置

不支援遷移NB-IoT網路通訊協定的裝置。

裝置管理

功能

說明

物模型

已遷移的產品資料無需修改。您也可根據業務需要,新增、修改當前配置。

說明

舊版公用執行個體保留原資料。為防止誤操作,執行個體遷移完成且確認業務正常後,建議您手動刪除該資料。

資料解析

標籤

需要在企業版執行個體重新添加標籤。

裝置分組

需要在企業版執行個體重新添加分組。

說明

舊版公用執行個體的原分組中依然顯示裝置,執行對應操作時,會報異常。建議您刪除遷移裝置對應的分組。

進階搜尋

可檢索到已遷移到目標企業版執行個體中資料。

裝置任務

需要在企業版執行個體重新建立產品相關的任務。

裝置影子

可繼續使用裝置影子緩衝機制。

檔案管理

您可在目標企業版執行個體中,查看裝置已上傳的檔案。

NTP服務

可繼續在企業版執行個體下,使用NTP服務解決無法即時地擷取服務端時間的問題。

網關子裝置

僅當遷移過程中拓撲關係不發生改變,子裝置可正常接入物聯網平台。否則,子裝置串連物聯網平台會報錯。

裝置分發

全球統一接入裝置,執行個體遷移成功後,裝置建連會出現異常。

訊息通訊

功能

說明

服務端訂閱

已遷移的訂閱設定和流轉規則可直接使用。您也可根據業務需要,新增、修改服務端訂閱和雲產品流轉。

警告
  • 若配置了AMQP服務端訂閱,需配置新的AMQP用戶端接入SDK。

  • 若使用了雲端API的服務端訂閱或雲產品流轉相關業務,還需修改相關API的請求參數。例如,GetRule介面的請求參數RuleId

更多詳細說明,請參見開發指南

雲產品流轉

情境聯動

需要在企業版執行個體重新建立情境聯動規則。

RRPC通訊

調用RRpcPubBroadcast等通訊介面,必須傳入企業版執行個體的執行個體ID。

廣播通訊

監控營運

功能

說明

即時監控

裝置、訊息、物模型和規則引擎相關指標資料,會隨著遷移進度發生變化。您可即時監控裝置接入和訊息通訊是否正常。

產品資料移轉過程中,業務資料所屬執行個體發生變更,公用執行個體下遷移相關的指標資料會下降,目標企業版執行個體下相關的指標資料會增加。如果公用執行個體配置了閾值降低預警,會觸發警示。建議您根據業務需要,關閉或修改警示規則。具體操作,請參見配置警示規則

營運大盤

線上調試

需在企業版執行個體中下髮指令給已遷移裝置,調試裝置端功能。

裝置模擬器

公用執行個體需關閉待遷移裝置的裝置模擬器,然後在企業版執行個體下重新啟動裝置模擬器。

Log Service

企業版執行個體的Log Service,無法查詢歷史資料。

OTA升級

為保證裝置正常進行OTA升級,需在企業版執行個體中重新添加OTA升級任務。

遠程配置

需在企業版執行個體中重新進行遠程配置。

警示中心

需在企業版執行個體中重新設定警示資訊。

安全隧道

為保證能遠端存取裝置,需在企業版執行個體中重新建立裝置安全隧道。

開發指南

  • 雲端API調用:

    您需修改相關業務API調用時的請求參數,傳入目標企業版執行個體的ID。

    雲端介面PubRRpcInvokeThingServiceSetDeviceProperty,相容傳入企業版執行個體ID,可以提交工單申請,減少服務端改造。

    警告

    企業版執行個體下,調用雲端SDK時,必須傳入企業版執行個體的ID。否則,調用會失敗,影響業務正常運行。改造建議,請參見遷移前的準備

  • AMQP用戶端接入:

    若已配置AMQP服務端訂閱或規則引擎流轉到AMQP,對於AMQP用戶端接入的SDK,需要複製新的企業版執行個體ID和接入網域名稱,配置新的AMQP用戶端,然後在灰階遷移後,複製更新消費組ID,啟動新的AMQP用戶端。

    警告

    對於已配置的AMQP服務端訂閱,您需要為公用執行個體和目標企業版執行個體,分別啟動一個AMQP用戶端。保證兩個執行個體同時存在AMQP用戶端接收資料,防止資料丟失。