Przewodnik rozwiązywania problemów z aktualizacją urządzenia dla IoT na potrzeby 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 usługi 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 jest .importmanifest.json | Co najmniej jeden manifest importu jest wymagany do zaimportowania każdej aktualizacji do usługi Device Update dla usługi IoT Hub. Aktualizacja serwera proxy może zawierać manifest importu nadrzędnego, a także pewną liczbę manifestów importu podrzędnego, 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 witrynie 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. |
| Brak wymaganego manifestu nadrzędnego. Rozszerzenie pliku dla manifestów importu jest .importmanifest.json | Aktualizacja serwera proxy może mieć nadrzędny manifest importu, a także pewną liczbę manifestów importu podrzędnego, 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 masz prawidłowy nadrzędny manifest importu, ale nie ma rozszerzenia .importmanifest.json na końcu nazwy pliku. To rozszerzenie jest wymagane do rozpoznawania manifestów importu przez proces importowania w witrynie 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ę manifestów importu podrzędnego, 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 jest zgodny z importem aktualizacji, a następnie usuń wszystkie inne, aby istniał tylko jeden nadrzędny manifest importu. Dowiedz się więcej o manifestach importu. |
| Brak co najmniej jednego manifestu podrzędnego wymienionego w obiekcie nadrzędnym ('parentimportfile.importmanifest.json'). Dodawanie wymaganych manifestów podrzędnych dla tych identyfikatorów aktualizacji | Aktualizacja serwera proxy może mieć manifest importu nadrzędnego, a także pewną liczbę manifestów importu podrzędnego. 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ć manifest importu nadrzędnego, a także pewną liczbę manifestów importu podrzędnego. Nadrzędny manifest importu zawiera odwołania do wszystkich manifestów importu podrzędnego w aktualizacji. Jeśli widzisz ten błąd, każdy manifest na liście jest manifestem importu podrzędnego, który znajduje się w aktualizacji, ale nie jest przywołyny w nadrzędnym manifeście importu. 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 jeden lub więcej plików, które nie są wymienione 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 zmieniono nazwy 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 tworzeniem manifestów importu. Aby rozwiązać ten problem, przejrzyj każdy manifest importu i sprawdź, czy nie ma problemów ze schematem . Dowiedz się więcej o manifestach importu. |