你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

导入代理更新的 Device Update for IoT 故障排除指南

  • 项目

本文档提供故障排除步骤和在将代理更新导入到 Device Update for IoT Hub 时可能会遇到的错误消息表。

Error messages

错误消息 如何进行故障排除
此上传中找不到任何导入清单。 导入清单的文件扩展名为 .importmanifest.json。 要导入到 Device Update for IoT Hub 的任何更新都必须至少有一个导入清单。 代理更新可以不仅具有父导入清单，还可以从父项引用一些子导入清单。

此错误的可能原因是你具有有效导入清单，但文件名末尾没有 .importmanifest.json 扩展。 在 Azure 门户中，此扩展是导入过程要识别的导入清单所必需的。 如果扩展是正确的，则应在更新中查看每个导入清单的架构中是否存在问题。 详细了解导入清单。
此上传缺少必需的父清单。 导入清单的文件扩展名为 .importmanifest.json。 代理更新可以包含父导入清单，还可以从父项引用一些子导入清单。 导入任何子更新时必须包含父清单，因为它包含有关这些子更新的必需信息。

此错误的可能原因是你具有有效的父导入清单，但文件名末尾没有 .importmanifest.json 扩展。 在 Azure 门户中，此扩展是导入过程要识别的导入清单所必需的。 如果扩展是正确的，则应查看每个父导入清单的架构中是否存在问题。 详细了解导入清单。
此上传包含 [n] 个父清单。 只允许定义二者中的一个。 删除不想要使用的清单，然后再次尝试上传。 代理更新可以包含父导入清单，还可以从父项引用一些子导入清单。 对于给定的更新，只能包含一个父清单，尽管可以有任意数量的子导入清单。 如果你看到此错误以及导入清单文件的列表，则其中每个文件都有相关信息，指示它是一个父导入清单。

要解决此问题，请首先确定哪个父导入清单与要导入的更新匹配，然后删除任何其他清单，这样就只有一个父导入清单。 详细了解导入清单。
上传缺少父 (parentimportfile.importmanifest.json) 中列出的一个或多个子清单。为这些更新 ID 添加所需的子清单 代理更新可能具有父导入清单，还可能包含一定数量的子导入清单。 父导入清单包括对更新中所有子导入清单的引用。 如果看到此错误，则你的父导入清单将引用列出的每个更新 ID 的子导入清单，但这些子导入清单不是更新的一部分。

要解决此问题，你需要将这些子导入清单中的每个清单添加到更新中，或者删除父导入清单中的引用。 详细了解导入清单。
上传包含父文件中未列出的子清单文件 (childmanifest.importmanifest.json)。请将其删除，然后重试。 代理更新可能具有父导入清单，还可能包含一定数量的子导入清单。 父导入清单包括对更新中所有子导入清单的引用。 如果看到此错误，则列出的每个清单都是在更新中存在但在父导入清单中未引用的子导入清单。

要解决此问题，需要删除这些子导入清单。 或者，你可以在父导入清单中添加对它们的引用。 详细了解导入清单。
缺少某些必需的更新文件。 请加入这些文件，然后再次上传。 代理更新可能具有多个导入清单，每个清单都引用多个更新文件。 如果在导入更新时未包括引用的任何文件，则会看到此错误。

要解决此问题，你将需要添加缺少的文件，或者从包含这些文件的导入清单中删除对这些文件的引用。 详细了解导入清单。
上传包含清单中未列出的一个或多个文件。 删除多余的文件，并再次尝试上传。 代理更新可能具有多个导入清单，每个清单都引用多个更新文件。 如果尝试导入未在导入清单中引用的任何更新文件，则会看到此错误。

要解决此问题，请删除错误消息中列出的文件。 或者，将每个文件的引用添加到其中一个导入清单中。 详细了解导入清单。
上传包含重复的文件名。 删除或重命名文件，确保每个名称都是唯一的。 更新可包含多个文件，但每个文件必须具有唯一的文件名。 如果尝试导入任何具有相同名称的更新文件，则会看到此错误。

要解决此问题，请删除或重命名错误消息中列出的文件。 如果重命名任何文件，请确保还在相应的导入清单中更改每个文件的关联引用。 详细了解导入清单。
一个或多个导入清单的格式不正确。 删除文件或调整其语法，然后重试。 如果你看到此错误，则说明你的导入清单创建方式存在问题。 要解决此问题，请查看每个列出的导入清单，并检查是否存在架构问题。 详细了解导入清单。

后续步骤