Kódy chyb služby Device Update pro IoT Hub
Tento dokument obsahuje tabulku kódů chyb pro různé součásti aktualizace zařízení.
Existují dvě primární komponenty na straně klienta, které můžou vyvolat kódy chyb: agent aktualizace zařízení a agent optimalizace doručení. Kódy chyb pocházejí také ze služby obsahu Device Update.
Agent aktualizace zařízení
ResultCode a ExtendedResultCode
Aktualizace zařízení pro sestavy ResultCode rozhraní IoT Hub Core PnP a ExtendedResultCodekterá se dá použít k diagnostice selhání. Další informace o rozhraní Device Update Core PnP najdete v tématu Aktualizace zařízení a technologie Plug and Play. Další podrobnosti týkající se výchozích významů agenta Device Update ResultCode a ExtendedResultCodes najdete v úložišti GitHub služby Device Update.
ResultCode je obecný stavový kód a ExtendedResultCode je celé číslo s kódovanými informacemi o chybě.
Zobrazí ExtendedResultCode se jako podepsané celé číslo v rozhraní PnP. Chcete-li dekódovat ExtendedResultCode, převeďte znaménko se znaménkem na šestnáctkové číslo bez znaménka. Používají se pouze prvních 4 bajty ExtendedResultCode a jsou ve tvaru FFFFFFF F, ve kterém je prvním štětát kódem zařízení a zbývající části bitů jsou kód chyby.
Kódy zařízení
| Kód zařízení | Popis |
|---|---|
| D | Chyba vyvolaná ze sady DO SDK |
| E | Kód chyby je předčítání |
Příklad:
ExtendedResultCode je -536870781
Nepodepsané šestnáctkové vyjádření -536870781 je FFFFFFFF E0000083.
| Ignorovat | Kód zařízení | Kód chyby |
|---|---|---|
| FFFFFFFFFF | E | 0000083 |
0x83 v šestnáctkové soustavě je 131 v desítkové soustavě, což je hodnota errno pro ENOLCK.
Agent optimalizace doručení
Následující tabulka uvádí kódy chyb týkající se komponenty Optimalizace doručení (DO) klienta služby Device Update. Komponenta DO zodpovídá za stahování obsahu aktualizace do zařízení IoT.
Kód chyby DO lze získat prozkoumáním výjimek vyvolaných v reakci na volání rozhraní API. Všechny kódy chyb DO je možné identifikovat pomocí předpony 0x80D0.
| Kód chyby | Chyba řetězce | Typ | Popis |
|---|---|---|---|
| 0x80D01001L | DO_E_NO_SERVICE | Není k dispozici | Optimalizace doručení nemohla poskytovat službu |
| 0x80D02002L | DO_E_DOWNLOAD_NO_PROGRESS | Stáhnout úlohu | Stažení souboru v definovaném období nevidělo žádný pokrok. |
| 0x80D02011L | DO_E_UNKNOWN_PROPERTY_ID | Stáhnout úlohu | SetProperty() nebo GetProperty() volaný s neznámým ID vlastnosti |
| 0x80D02012L | DO_E_READ_ONLY_PROPERTY | Stáhnout úlohu | Nelze volat SetProperty() pro vlastnost jen pro čtení |
| 0x80D02013L | DO_E_INVALID_STATE | Stáhnout úlohu | Požadovaná akce není v aktuálním stavu úlohy povolená. Úloha mohla být zrušena nebo dokončena. Je teď ve stavu jen pro čtení. |
| 0x80D02018L | DO_E_FILE_DOWNLOADSINK_UNSPECIFIED | Stáhnout úlohu | Nelze spustit stahování, protože nebyla zadána žádná jímka stahování (buď místní soubor nebo rozhraní streamu). |
| 0x80D02200L | DO_E_DOWNLOAD_NO_URI | IDODownload – rozhraní | Stahování bylo zahájeno bez zadání identifikátoru URI. |
| 0x80D03805L | DO_E_BLOCKED_BY_NO_NETWORK | Přechodné podmínky | Stahování pozastaveno kvůli ztrátě připojení k síti |
0 00 00000 Total 4 bytes (32 bits)
- -- -----
| | |
| | |
| | +--------- Error code (20 bits)
| |
| +------------- Component/Area code (8 bits)
|
+--------------- Facility code (4 bits)
Další informace o parsování kódů naleznete v tématu Kódy výsledků agenta Device Update a rozšířené kódy výsledků nebo implementace vlastní obslužné rutiny obsahu.
Služba obsahu aktualizace zařízení
Následující tabulka uvádí kódy chyb, které se týkají součásti služby obsahu služby služby Device Update. Komponenta služby obsahu zodpovídá za import obsahu aktualizace. Další informace o řešení potíží jsou k dispozici také pro import aktualizací proxy serveru.
| Kód chyby | Chyba řetězce | Další kroky |
|---|---|---|
| UpdateAlreadyExists | Aktualizace se stejnou identitou již existuje. | Ujistěte se, že importujete aktualizaci, která ještě nebyla importována do této instance služby Device Update pro IoT Hub. |
| DuplicateContentImport | Identický obsah importovaný současně vícekrát. | Ujistěte se, že importujete aktualizaci, která ještě nebyla importována do této instance služby Device Update pro IoT Hub. |
| CannotProcessImportManifest | Při zpracování manifestu importu došlo k chybě. | Informace o správném formátování manifestu importu najdete v konceptech importu a dokumentaci k aktualizaci importu . |
| Nejde stáhnout | Nelze stáhnout manifest importu. | Zkontrolujte, jestli je adresa URL souboru manifestu importu stále platná. |
| Nejdeparse | Manifest importu nelze analyzovat. | Zkontrolujte přesnost manifestu importu pro schéma definované v dokumentaci k aktualizaci importu. |
| Nepodporovaná verze | Verze schématu manifestu importu není podporována. | Ujistěte se, že manifest importu používá nejnovější schéma definované v dokumentaci k aktualizaci importu. |
| Při importu aktualizace došlo k chybě kvůli překročení limitu. | Nelze importovat dalšího zprostředkovatele aktualizace. | Dosáhli jste limitu počtu různých poskytovatelů povolených ve vaší instanci služby Device Update pro IoT Hub. Odstraňte některé aktualizace z vaší instance a zkuste to znovu. |
| Při importu aktualizace došlo k chybě kvůli překročení limitu. | Nelze importovat další název aktualizace pro zadaného zprostředkovatele. | Dosáhli jste limitu počtu různých názvů povolených u jednoho poskytovatele ve vaší instanci služby Device Update pro IoT Hub. Odstraňte některé aktualizace z vaší instance a zkuste to znovu. |
| Při importu aktualizace došlo k chybě kvůli překročení limitu. | Nelze importovat další verzi aktualizace pro zadaného zprostředkovatele a název. | Dosáhli jste limitu počtu různých verzí povolených v rámci jednoho poskytovatele a názvu ve vaší instanci služby Device Update pro IoT Hub. Odstraňte některé aktualizace s tímto názvem z vaší instance a zkuste to znovu. |
| Při importu aktualizace došlo k chybě kvůli překročení limitu. | Nelze importovat dalšího zprostředkovatele aktualizací se zadanou kompatibilitou. nebo Nelze importovat další název aktualizace se zadanou kompatibilitou. nebo Nelze importovat další verzi aktualizace se zadanou kompatibilitou. |
Při definování vlastností kompatibility v manifestu importu mějte na paměti, že služba Device Update pro IoT Hub podporuje jednu kombinaci zprostředkovatelů a názvů pro danou sadu vlastností kompatibility. Pokud se pokusíte použít stejné vlastnosti kompatibility s více než jednou kombinací zprostředkovatele nebo názvu, zobrazí se tyto chyby. Pokud chcete tento problém vyřešit, ujistěte se, že všechny aktualizace pro dané zařízení (jak jsou definovány vlastnostmi kompatibility) používají stejného zprostředkovatele a názvu. |
| Soubor CannotProcessUpdateFile | Při zpracování zdrojového souboru došlo k chybě. | |
| ContentFileCannotDownload | Zdrojový soubor nelze stáhnout. | Zkontrolujte, jestli je adresa URL pro aktualizační soubory stále platná. |
| SourceFileMalwareDetected | V importovaném souboru byl zjištěn známý podpis malwaru. | Služba Device Update pro IoT Hub prohledá importovaný obsah malwaru pomocí několika různých mechanismů. Pokud je zjištěn známý podpis malwaru, import selže a vrátí se jedinečná chybová zpráva. Chybová zpráva obsahuje popis podpisu malwaru a hodnotu hash souboru pro každý soubor, ve kterém byl podpis zjištěn. Pomocí hodnoty hash souboru můžete najít přesný soubor označený příznakem a pomocí popisu podpisu malwaru tento soubor zkontrolovat u malwaru. Po odebrání malwaru z importovaných souborů můžete proces importu spustit znovu. |
| SourceFilePendingMalwareAnalysis | V importovaném souboru byl zjištěn podpis, který může znamenat přítomnost malwaru. | Služba Device Update pro IoT Hub prohledá importovaný obsah malwaru pomocí několika různých mechanismů. Import selže, pokud má podpis kontroly charakteristiky malwaru, i když neexistuje přesná shoda se známým malwarem. V takovém případě se vrátí jedinečná chybová zpráva. Chybová zpráva obsahuje popis podezřelého malwarového podpisu a hodnotu hash souboru pro každý soubor, ve kterém byl podpis zjištěn. Pomocí hodnoty hash souboru můžete najít přesný soubor označený příznakem a pomocí popisu podpisu malwaru tento soubor zkontrolovat u malwaru. Po odebrání malwaru z importovaných souborů můžete proces importu spustit znovu. Pokud jste si jistí, že vaše soubory nejsou škodlivého softwaru a dál se vám zobrazí tato chyba, použijte proces kontaktního podpora Microsoftu. |