匯入 Proxy 更新的 IoT 中樞裝置更新疑難排解指南
本文件針對將 Proxy 更新匯入 IoT 中樞裝置更新時可能出現的錯誤訊息提供相關資料表和疑難排解步驟。
錯誤訊息
| 錯誤訊息 | 如何進行疑難排解 |
|---|---|
| 上傳內容中找不到匯入資訊清單。 匯入資訊清單的檔案副檔名為 .importmanifest.json | 若要將更新匯入 IoT 中樞裝置更新，至少需要一份匯入資訊清單。 Proxy 更新可能同時有一份父代匯入資訊清單和多份參考父代的子系匯入資訊清單。 會發生這項錯誤，可能是因為您雖擁有有效的匯入資訊清單，但其檔案名稱結尾沒有 .importmanifest.json 副檔名。 匯入資訊清單必須有此副檔名，在 Azure 入口網站的匯入程序中才會受到認可。 如果副檔名正確，請逐一檢閱更新中每份匯入資訊清單的結構描述，確認是否有任何問題。 深入了解匯入資訊清單。 |
| 上傳內容缺少必要的父代資訊清單。 匯入資訊清單的檔案副檔名為 .importmanifest.json | Proxy 更新可能有一份父代匯入資訊清單和多份參考父代的子系匯入資訊清單。 匯入任何子系更新時都必須包含父代資訊清單，因為其中包含這些子系更新的相關必要資訊。 會發生這項錯誤，可能是因為您雖擁有有效的父代匯入資訊清單，但其檔案名稱結尾沒有 .importmanifest.json 副檔名。 匯入資訊清單必須有此副檔名，在 Azure 入口網站的匯入程序中才會受到認可。 如果副檔名正確，請檢閱匯入父代資訊清單的結構描述，確認是否有任何問題。 深入了解匯入資訊清單。 |
| 上傳內容包含「多個」父代資訊清單， 但只能允許一個條件約束。 刪除您不想使用的資訊清單，然後再次嘗試上傳。 | Proxy 更新可能有一份父代匯入資訊清單和多份參考父代的子系匯入資訊清單。 雖然特定更新中可以有一或多份子系匯入資訊清單，但只能包含一份父代資訊清單。 如果您看到這項錯誤以及匯入資訊清單檔案列表，則其中「每個」檔案的資訊都會表明其為父代匯入資訊清單。 若要解決此問題，請先判斷哪份父代匯入資訊清單符合您要匯入的更新，然後移除所有其他項目，只留下一份父代匯入資訊清單。 深入了解匯入資訊清單。 |
| 上傳內容缺少父代資訊清單中列出的一或多個子系資訊清單('parentimportfile.importmanifest.json')。請為這些更新識別碼新增所需子系資訊清單 | Proxy 更新可能有一份父代匯入資訊清單和多份子系匯入資訊清單。 您更新中的父代匯入資訊清單包含對所有子系匯入資訊清單的參考。 如果您看到這項錯誤，代表父代匯入資訊清單參考了每個列出更新識別碼的子系匯入資訊清單，但這些子系匯入資訊清單並不屬於更新的一部分。 若要解決這項問題，您必須將缺少的每份子系匯入資訊清單新增至更新，或移除父系匯入資訊清單中的參考。 深入了解匯入資訊清單。 |
| 上傳內容包含父代資訊清單中未列出的子系資訊清單檔('childmanifest.importmanifest.json')。請刪除該檔案，然後再試一次。 | Proxy 更新可能有一份父代匯入資訊清單和多份子系匯入資訊清單。 您更新中的父代匯入資訊清單包含對所有子系匯入資訊清單的參考。 如果您看到這項錯誤，代表每份列出的資訊清單都是更新中存在的子系匯入資訊清單，但並未在父代匯入資訊清單中受到參考。 若要解決這項問題，請移除這類子系匯入清單， 或在父代匯入資訊清單中新增這些子系匯入清單的參考。 深入了解匯入資訊清單。 |
| 缺少必要更新檔案。 請加入這些檔案，然後再次嘗試上傳。 | Proxy 更新可能有多份匯入資訊清單，每份都會參考多個更新檔案。 如果您匯入更新時未包含任一參考檔案，就會看到這項錯誤。 若要解決這項問題，您必須新增遺漏的檔案，或從包含這些檔案的匯入資訊清單中移除對這些檔案的參考。 深入了解匯入資訊清單。 |
| 上傳內容包含資訊清單中未列出的一或多個檔案。 請刪除額外的檔案，然後再次嘗試上傳。 | Proxy 更新可能有多份匯入資訊清單，每份都會參考多個更新檔案。 如果您嘗試匯入任何匯入資訊清單中未參考的更新檔案，就會看到這則錯誤訊息。 若要解決這項問題，請移除錯誤訊息中列出的檔案， 或將每個檔案的參考新增至其中一個匯入資訊清單。 深入了解匯入資訊清單。 |
| 上傳內容包含重複的檔案名稱。 請刪除或重新命名檔案，確保所有名稱不會重複。 | 更新可以包含多個檔案，但每個檔案都必須有唯一的檔案名稱。 如果您嘗試匯入任何名稱相同的更新檔案，就會看到這則錯誤。 若要解決這項問題，請移除錯誤訊息中列出的檔案。 如果您將任何檔案重新命名，請務必同時變更相關匯入資訊清單中每個檔案的相關參考。 深入了解匯入資訊清單。 |
| 一或多份匯入資訊清單的格式不正確。 請刪除該檔案或調整語法，然後再試一次。 | 如果您看到這項錯誤，代表匯入資訊清單的建立方式有問題。 若要解決此問題，請檢閱每個列出的匯入資訊清單，並檢查是否有結構描述問題。 深入了解匯入資訊清單。 |