舊版公用執行個體已不支援資源規格擴容，如果資源規格不足，物聯網平台提供執行個體遷移功能，可協助您將舊版公用執行個體下產品、裝置和訊息轉寄資料移轉到同帳號同地區下的標準型企業版執行個體中使用，降低遷移影響和系統改造成本。本文介紹執行個體遷移功能使用的相關說明。
使用限制
僅舊版公用執行個體下，支援使用執行個體遷移功能，將對應資料移轉到標準型企業版執行個體中使用。執行個體的詳細說明，請參見執行個體概述。
限制項 | 描述 | 限制 |
遷移並發量 | 裝置分發和執行個體遷移任務並發執行的任務總數量上限。 說明 物聯網平台也支援將整合了裝置分發能力的裝置遷移到企業版執行個體。具體內容，請參見裝置分發。 | 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需要更新。更多內容，請參見遷移前的準備。
全量遷移成功後，您需檢查業務運行狀態和結果，保證雲端介面的調用，已切換到目標企業版執行個體。
可選：復原遷移任務：若遷移失敗或出現問題，可復原已遷移的全部裝置資料（裝置認證資訊和物模型資料）到公用執行個體正常運行。此操作不會刪除目標企業版執行個體中已遷移的服務端訂閱和訊息轉寄資料。