本文中含有需要您注意的重要提示信息，忽略該信息可能對您的業務造成影響，請務必仔細閱讀。
舊版公共實例已不支持資源規格擴容，如果資源規格不足，物聯網平臺提供實例遷移功能，可幫助您將舊版公共實例下產品、設備和消息轉發數據遷移到同賬號同地域下的標準型企業版實例中使用，降低遷移影響和系統改造成本。本文介紹實例遷移功能使用的相關說明。
使用限制
僅舊版公共實例下，支持使用實例遷移功能，將對應數據遷移到標準型企業版實例中使用。實例的詳細說明，請參見實例概述。
限制項 | 描述 | 限制 |
遷移并發量 | 設備分發和實例遷移任務并發執行的任務總數量上限。 說明 物聯網平臺也支持將集成了設備分發能力的設備遷移到企業版實例。具體內容，請參見設備分發。 | 5 |
同時在線設備數 | 目標企業版實例下可用的同時在線設備數規格下限。 | 超過待遷移的設備數量。 |
目標企業版實例 |
| 1 |
設備 | 一個產品下支持遷移設備個數上限。 說明 若此限制數量不能滿足您的業務需求，請提交工單說明您的需求。 | 500,000 |
遷移前須知
遷移前，您需了解以下信息，便于您評估實例遷移的業務影響。
遷移數據：
遷移公共實例時，物聯網平臺系統會自動同步遷移公共實例中的產品、設備和消息轉發數據，具體遷移數據參見下表。
數據項
遷移數據
注意事項
產品
產品信息：ProductKey、名稱、節點類型、品類等。
功能定義：屬性、服務、事件，以及擴展物模型（包含物模型的草稿數據）。
腳本：數據解析腳本（包含腳本的草稿數據）。
支持遷移一機一密和一型一密預注冊認證方式的產品和設備。
對于網關子設備，遷移過程中拓撲關系不變，遷移后可正常接入物聯網平臺。因此，若遷移網關設備或其子設備，需將網關設備及其子設備同時遷移到同一企業版實例下。
授權的產品和設備不支持遷移。企業版實例下不支持產品和設備的授權功能。
已使用數據服務的產品和設備，不支持遷移。
已開通視頻服務的產品和設備，不支持遷移。
同時接入物聯網邊緣計算或生活物聯網平臺的產品和設備，不支持遷移。
遷移后，產品物模型校驗類型不變。
遷移后，舊版公共實例下保留原數據。為防止誤操作，實例遷移完成且確認業務正常后，建議您手動刪除該數據。
設備
設備信息：設備證書信息，保證設備證書全局唯一。
設備數據：物模型屬性、事件和服務數據。
重要實例下分發的設備不支持遷移。
待遷移設備必須具備重連功能。您需完成設備端SDK開發，并將設備接入物聯網平臺進行正常通信。
說明如果使用物聯網平臺提供的Link SDK開發設備，設備端會自動連接到企業版實例，無需修改設備接入域名。Link SDK的詳細內容，請參見設備接入。
如果沒有使用物聯網平臺提供的設備端SDK，需要修改設備接入域名，需您自研設備的重連邏輯。
遷移中，若設備在線，該設備會被迫下線。
遷移后，舊版公共實例下自動刪除已遷移設備。設備端SDK無需修改，可成功接入目標企業版實例，并正常通信。
設備物模型數據遷移的使用說明：
默認數據同步關閉。您可在創建遷移任務后，手動開啟數據同步，以保證實例遷移過程中業務不受影響。
開啟數據同步后，從開啟數據同步的時間點開始，最多延遲1分鐘后，同步公共實例內待遷移產品下設備上報的數據到目標企業版實例。從開啟數據同步的當天時間開始，最多支持同步往后30天內的數據。
設備數據同步功能，支持手動關閉和重新開啟。若未手動關閉數據同步，30天后系統會自動關閉數據同步。數據同步被關閉前，請確保完成實例遷移，以免影響相關業務。
數據同步是單向的，即僅支持同步公共實例內待遷移產品下設備上報的數據到企業版實例。
數據同步開啟時，若設備從企業版實例回滾到公共實例，已遷移的設備數據不會回滾。當設備再次遷移到企業版實例時，保證企業版實例內數據完整，而公共實例內數據會不完整。
消息轉發
服務端訂閱：AMQP、MNS服務端訂閱配置以及訂閱關系。
云產品流轉：流轉規則，包括SQL設置、數據源、數據目的（例如RocketMQ、TSDB、RDS、FC等）和解析腳本等。
消費組：消費組信息。遷移后，會創建新的消費組ID。
遷移后，舊版公共實例下保留原數據。為防止誤操作，實例遷移完成且確認業務正常后，建議您手動刪除該數據。
若已配置AMQP服務端訂閱或消息轉發到AMQP，需啟動兩個AMQP客戶端，保證公共實例和企業版實例同時存在AMQP客戶端接收數據，防止數據丟失。
企業版實例不支持服務端訂閱HTTP2方式接入，原公共實例的服務端訂閱HTTP2方式接入，建議修改為AMQP方式接入。
功能使用：
設備遷移到目標企業版實例后，對于已遷移的配置，可繼續正常使用。若使用更多功能，您可在企業版實例中重新配置。功能使用的詳細說明，請參見遷移后功能使用說明。
計費說明：
遷移到企業版實例下的設備，消息通信、連接時長和OTA升級不再計費。
遷移前的準備
了解遷移數據和功能使用后，遷移實例前，您需評估業務影響，完成業務系統改造，保證設備遷移后正常通信。
業務項 | 評估與處理 | 相關文檔 |
產品和設備 | 確認待遷移產品和設備，是否符合遷移要求。產品和設備的遷移說明，請參見遷移前須知中的《注意事項》。 若待遷移的是授權的產品和設備，請先取消授權。 | |
AMQP服務端訂閱 | 確認是否已配置AMQP服務端訂閱或消息轉發到AMQP。 若已配置，對于AMQP客戶端接入的SDK，需要復制新的企業版實例ID和接入域名，配置新的AMQP客戶端，然后在灰度遷移后，復制更新消費組ID，啟動新的AMQP客戶端。 | |
云產品流轉 | 在公共實例下，配置流轉數據：
| |
設備OTA升級 | 確認待遷移產品下是否包含設備OTA升級任務。 若存在，請停止OTA升級任務。否則，在實例遷移過程中，OTA升級可能會失敗，且運行中的OTA升級任務會繼續產生計費。 | |
云端API調用 | 確認已遷移設備是否開發了調用云端API的業務。 若有相關業務，您需修改調用云端API時的請求參數，傳入目標企業版實例的ID。 您需自行開發應用或服務器，在調用云端接口時，先查詢數據庫表中實例ID信息（企業版實例ID），然后設置接口請求參數IotInstanceId為該企業版實例ID，最后發起接口調用。 服務端修改示例，請參見實例遷移服務端修改示例。 |
遷移的整體流程
如上圖所示，實例遷移整理流程分為以下四部分。
流程 | 說明 |
業務評估 | 實例遷移前，您需評估業務影響。詳細說明，請參見遷移前須知。 |
系統改造 | 根據業務評估，對您的業務系統進行改造，保證公共實例和企業版實例下設備相關業務的正常運行。主要業務有：
警告
更多內容，請參見遷移前的準備。 |
實例遷移 | 在物聯網平臺控制臺，創建實例遷移任務，遷移指定的待遷移產品相關數據。詳細說明，請參見遷移的操作步驟。 |
接口切流 | 全量遷移成功后，檢查業務運行狀態和結果：確認云端接口的調用，已切換到目標企業版實例。 建議您在系統改造時，先訂閱設備遷移的流轉數據，設備遷移成功后會更新數據庫表中設備所屬實例的信息為企業版實例ID。調用云端接口時，會先查詢數據庫表中實例ID信息（企業版實例ID），然后設置接口請求參數IotInstanceId為該企業版實例ID，最后調用接口。 |
遷移的操作步驟
步驟一：創建遷移任務：為指定產品添加遷移任務。
重要為保證實例遷移過程中業務不受影響，您可在創建遷移任務后，手動開啟數據同步，將公共實例內待遷移產品下設備上報的數據遷移到目標企業版實例。具體操作，請參見開啟數據同步。
步驟二：灰度遷移：依次復制產品和消息轉發數據、遷移指定的待灰度設備數據。
警告若已配置AMQP服務端訂閱或消息轉發到AMQP，灰度完成后，需復制更新消費組ID，啟動新的AMQP客戶端接入的SDK，用于接收數據。
觀察并確保遷移任務對業務無影響后，再進行全量遷移。
步驟三：全量遷移：查詢指定產品下的全部數據，遷移全量設備數據。
警告請確保系統改造已完成，并發布上線。例如云端API調用必須傳入企業版實例ID、AMQP客戶端SDK中消費組ID需要更新。更多內容，請參見遷移前的準備。
全量遷移成功后，您需檢查業務運行狀態和結果，保證云端接口的調用，已切換到目標企業版實例。
可選：回滾遷移任務：若遷移失敗或出現問題，可回滾已遷移的全部設備數據（設備證書信息和物模型數據）到公共實例正常運行。此操作不會刪除目標企業版實例中已遷移的服務端訂閱和消息轉發數據。