Przewodnik rozwiązywania problemów z usługą Device Update dla IoT dotyczący importowania aktualizacji serwera proxy
Ten dokument zawiera kroki rozwiązywania problemów i tabelę komunikatów o błędach, które mogą wystąpić podczas importowania aktualizacji serwera proxy do usługi Device Update dla IoT Hub.
Komunikaty o błędach
| Komunikat o błędzie | Sposoby rozwiązywania problemów |
|---|---|
| W tym przekazaniu nie znaleziono manifestu importu. Rozszerzenie pliku dla manifestów importu to .importmanifest.json | Co najmniej jeden manifest importu jest wymagany do zaimportowania każdej aktualizacji do usługi Device Update dla IoT Hub. Aktualizacja serwera proxy może zawierać manifest importu nadrzędnego, a także pewną liczbę podrzędnych manifestów importu, do których odwołuje się element nadrzędny. Przyczyną tego błędu jest to, że masz prawidłowe manifesty importu, ale nie mają rozszerzenia .importmanifest.json na końcu nazwy pliku. To rozszerzenie jest wymagane do rozpoznawania manifestów importu przez proces importowania w Azure Portal. Jeśli rozszerzenie jest poprawne, należy przejrzeć schemat każdego manifestu importu w aktualizacji pod kątem wszelkich problemów. Dowiedz się więcej o manifestach importu. |
| W tym przekazaniu brakuje wymaganego manifestu nadrzędnego. Rozszerzenie pliku dla manifestów importu to .importmanifest.json | Aktualizacja serwera proxy może mieć nadrzędny manifest importu, a także pewną liczbę podrzędnych manifestów importu, do których odwołuje się element nadrzędny. Manifest nadrzędny musi zostać uwzględniony podczas importowania aktualizacji podrzędnych, ponieważ zawiera wymagane informacje o tych aktualizacjach podrzędnych. Przyczyną tego błędu jest to, że na końcu nazwy pliku znajduje się prawidłowy manifest importu nadrzędnego, ale nie ma rozszerzenia importmanifest.json . To rozszerzenie jest wymagane do rozpoznawania manifestów importu przez proces importowania w Azure Portal. Jeśli rozszerzenie jest poprawne, należy przejrzeć schemat nadrzędnego manifestu importu pod kątem wszelkich problemów. Dowiedz się więcej o manifestach importu. |
| To przekazywanie zawiera manifesty nadrzędne [n]. Dozwolone jest tylko jedno. Usuń manifesty, których nie chcesz używać, i spróbuj przekazać ponownie. | Aktualizacja serwera proxy może mieć nadrzędny manifest importu, a także pewną liczbę podrzędnych manifestów importu, do których odwołuje się element nadrzędny. Dla danej aktualizacji można uwzględnić tylko jeden manifest nadrzędny, chociaż może istnieć dowolna liczba manifestów importu podrzędnego. Jeśli ten błąd zostanie wyświetlony wraz z listą plików manifestu importu, każdy z tych plików zawiera informacje wskazujące, że jest to nadrzędny manifest importu. Aby rozwiązać ten problem, najpierw określ, który nadrzędny manifest importu pasuje do importowanych aktualizacji, a następnie usuń wszystkie inne, aby istniał tylko jeden nadrzędny manifest importu. Dowiedz się więcej o manifestach importu. |
| W elemecie parent('parentimportfile.importmanifest.json')brakuje co najmniej jednego manifestu podrzędnego. Dodawanie wymaganych manifestów podrzędnych dla tych identyfikatorów aktualizacji | Aktualizacja serwera proxy może mieć nadrzędny manifest importu, a także pewną liczbę podrzędnych manifestów importu. Nadrzędny manifest importu zawiera odwołania do wszystkich manifestów importu podrzędnego w aktualizacji. Jeśli zostanie wyświetlony ten błąd, nadrzędny manifest importu odwołuje się do manifestu importu podrzędnego dla każdego z wymienionych identyfikatorów aktualizacji, ale te podrzędne manifesty importu nie są częścią aktualizacji. Aby rozwiązać ten problem, należy dodać każdy z tych podrzędnych manifestów importu do aktualizacji lub usunąć odwołania w nadrzędnym manifeście importu. Dowiedz się więcej o manifestach importu. |
| Przekazywanie zawiera podrzędne pliki manifestu('childmanifest.importmanifest.json'),które nie są wymienione w elemecie nadrzędnym. Usuń go i spróbuj ponownie. | Aktualizacja serwera proxy może mieć nadrzędny manifest importu, a także pewną liczbę podrzędnych manifestów importu. Nadrzędny manifest importu zawiera odwołania do wszystkich manifestów importu podrzędnego w aktualizacji. Jeśli zostanie wyświetlony ten błąd, każdy manifest na liście jest manifestem importu podrzędnego, który znajduje się w aktualizacji, ale nie odwołuje się do manifestu importu nadrzędnego. Aby rozwiązać ten problem, należy usunąć te podrzędne manifesty importu. Możesz też dodać odwołania do nich w nadrzędnym manifeście importu. Dowiedz się więcej o manifestach importu. |
| Brakuje niektórych wymaganych plików aktualizacji. Dołącz je i spróbuj przekazać ponownie. | Aktualizacja serwera proxy może zawierać wiele manifestów importu, z których każdy odwołuje się do wielu plików aktualizacji. Jeśli którykolwiek z plików, do których się odwołujesz, nie zostanie uwzględniony podczas importowania aktualizacji, zostanie wyświetlony ten błąd. Aby rozwiązać ten problem, należy dodać brakujące pliki lub usunąć odwołania do tych plików z manifestu importu, który je zawiera. Dowiedz się więcej o manifestach importu. |
| Przekazywanie zawiera co najmniej jeden plik, który nie znajduje się na liście w manifeście. Usuń dodatkowe pliki i spróbuj przekazać ponownie. | Aktualizacja serwera proxy może zawierać wiele manifestów importu, z których każdy odwołuje się do wielu plików aktualizacji. Ten błąd zostanie wyświetlony, jeśli spróbujesz zaimportować pliki aktualizacji, do których nie odwołujesz się w manifeście importu. Aby rozwiązać ten problem, usuń pliki wymienione w komunikacie o błędzie. Możesz też dodać odwołanie dla każdego pliku do jednego z manifestów importu. Dowiedz się więcej o manifestach importu. |
| Przekazywanie zawiera zduplikowane nazwy plików. Usuń lub zmień nazwy plików, aby każda nazwa jest unikatowa. | Aktualizacja może zawierać wiele plików, ale każdy plik musi mieć unikatową nazwę pliku. Jeśli spróbujesz zaimportować wszystkie pliki aktualizacji o tej samej nazwie, zostanie wyświetlony ten błąd. Aby rozwiązać ten problem, usuń lub zmień nazwę plików wymienionych w komunikacie o błędzie. Jeśli zmienisz nazwę jakichkolwiek plików, pamiętaj również o zmianie skojarzonego odwołania dla każdego pliku w odpowiednim manifeście importu. Dowiedz się więcej o manifestach importu. |
| Co najmniej jeden manifest importu nie został poprawnie sformatowany. Usuń plik lub dostosuj jego składnię i spróbuj ponownie. | Jeśli widzisz ten błąd, występuje problem z sposobem utworzenia manifestów importu. Aby rozwiązać ten problem, przejrzyj każdy manifest importu na liście i sprawdź, czy nie ma problemów ze schematem . Dowiedz się więcej o manifestach importu. |