IoT Hub-hibakódok eszközfrissítése
Ez a dokumentum hibakódokat tartalmaz a különböző eszközfrissítési összetevőkhöz.
Két elsődleges ügyféloldali összetevő okozhat hibakódokat: az eszközfrissítési ügynököt és a kézbesítésoptimalizálási ügynököt. A hibakódok az Eszközfrissítés tartalomszolgáltatásból is származnak.
Eszközfrissítési ügynök
ResultCode és ExtendedResultCode
Az IoT Hub Core PnP-felületének eszközfrissítési jelentései ResultCode és ExtendedResultCodea hibák diagnosztizálására használható. A Device Update Core PnP felületével kapcsolatos további információkért lásd : Eszközfrissítés és Plug and Play. Az eszközfrissítési ügynök ResultCode és ExtendedResultCodes alapértelmezett jelentéseivel kapcsolatos további információkért tekintse meg az Eszközfrissítési GitHub-adattárat.
ResultCode egy általános állapotkód, amely ExtendedResultCode kódolt hibainformációkat tartalmazó egész szám.
A ExtendedResultCode PnP-felületen aláírt egész számként jelenik meg. A ExtendedResultCodekódoláshoz konvertálja az aláírt egész számot aláíratlan hexává. A rendszer csak az első 4 bájtot ExtendedResultCode használja, és olyan formábanFFFFFFFFvan, amelyben az első nibble a létesítménykód, a többi bit pedig a hibakód.
Létesítménykódok
| Létesítmény kódja | Leírás |
|---|---|
| T | A DO SDK-ból származó hiba |
| E | A hibakód egy errno |
Példa:
ExtendedResultCode a -536870781
Az aláíratlan hexa -536870781 az .FFFFFFFF E0000083
| Mellőzés | Létesítmény kódja | Hibakód |
|---|---|---|
| FFFFFFFF | E | 0000083 |
0x83 a hexa 131 decimális, ami a függvény errno értéke ENOLCK.
Kézbesítésoptimalizálási ügynök
Az alábbi táblázat az eszközfrissítési ügyfél kézbesítésoptimalizálási (DO) összetevőjére vonatkozó hibakódokat sorolja fel. A DO-összetevő felelős a frissítési tartalom IoT-eszközre való letöltéséért.
A DO hibakód az API-hívásra adott válaszként kapott kivételek vizsgálatával szerezhető be. Az összes DO hibakód azonosítható a 0x80D0 előtaggal.
| Hibakód | Sztringhiba | Típus | Leírás |
|---|---|---|---|
| 0x80D01001L | DO_E_NO_Standard kiadás RVICE | n.a. | A kézbesítésoptimalizálás nem tudta biztosítani a szolgáltatást |
| 0x80D02002L | DO_E_DOWNLOAD_NO_PROGRESS | Feladat letöltése | A fájl letöltése nem látott előrehaladást a megadott időszakon belül |
| 0x80D02011L | DO_E_UNKNOWN_PROPERTY_ID | Feladat letöltése | Ismeretlen tulajdonságazonosítóval hívott SetProperty() vagy GetProperty() |
| 0x80D02012L | DO_E_READ_ONLY_PROPERTY | Feladat letöltése | A SetProperty() nem hívható meg írásvédett tulajdonságon |
| 0x80D02013L | DO_E_INVALID_STATE | Feladat letöltése | A kért művelet nem engedélyezett az aktuális feladatállapotban. Előfordulhat, hogy a feladatot megszakították vagy befejezték az átvitelt. Most már írásvédett állapotban van. |
| 0x80D02018L | DO_E_FILE_DOWNLOADSINK_UNSPECIFIED | Feladat letöltése | Nem sikerült elindítani a letöltést, mert nincs megadva letöltési fogadó (helyi fájl vagy streamfelület) |
| 0x80D02200L | DO_E_DOWNLOAD_NO_URI | IDODownload Interface | A letöltés URI megadása nélkül indult el |
| 0x80D03805L | DO_E_BLOCKED_BY_NO_NETWORK | Átmeneti feltételek | A letöltés a hálózati kapcsolat megszakadása miatt szünetel |
0 00 00000 Total 4 bytes (32 bits)
- -- -----
| | |
| | |
| | +--------- Error code (20 bits)
| |
| +------------- Component/Area code (8 bits)
|
+--------------- Facility code (4 bits)
Az elemzési kódokról további információt az Eszközfrissítési ügynök eredménykódjai és a kiterjesztett eredménykódok, illetve egyéni tartalomkezelő implementálása című témakörben talál.
Eszközfrissítési tartalomszolgáltatás
Az alábbi táblázat az eszközfrissítési szolgáltatás tartalomszolgáltatás-összetevőjére vonatkozó hibakódokat sorolja fel. A tartalomszolgáltatás-összetevő felelős a frissítési tartalom importálásáért. További hibaelhárítási információk a proxyfrissítések importálásához is elérhetők.
| Hibakód | Sztringhiba | Következő lépések |
|---|---|---|
| UpdateAlreadyExists | Ugyanazzal az identitással már létezik frissítés. | Győződjön meg arról, hogy olyan frissítést importál, amely még nem lett importálva az IoT Hub eszközfrissítési példányába. |
| DuplicateContentImport | Azonos tartalom, amely egyszerre több alkalommal is importálva van. | Győződjön meg arról, hogy olyan frissítést importál, amely még nem lett importálva az IoT Hub eszközfrissítési példányába. |
| CannotProcessImportManifest | Hiba történt az importálási jegyzék feldolgozása során. | Tekintse meg az importálási fogalmakat és a frissítési dokumentációt az importálási jegyzék megfelelő formázásához. |
| Nem tölthető le | Az importálási jegyzék nem tölthető le. | Ellenőrizze, hogy az importálási jegyzékfájl URL-címe továbbra is érvényes-e. |
| Nem lehet elemezni | Az importálási jegyzék nem elemezhető. | Ellenőrizze az importálási jegyzékben szereplő pontosságot az importálási frissítés dokumentációjában meghatározott sémával szemben. |
| UnsupportedVersion | A jegyzékséma importálása nem támogatott. | Győződjön meg arról, hogy az importálási jegyzék az importálási frissítés dokumentációjában meghatározott legújabb sémát használja. |
| Hiba történt a frissítés importálásakor a túllépett korlát miatt. | Nem importálható további frissítésszolgáltató. | Elérte az IoT Hub eszközfrissítési példányában engedélyezett különböző szolgáltatók számát. Töröljön néhány frissítést a példányból, és próbálkozzon újra. |
| Hiba történt a frissítés importálásakor a túllépett korlát miatt. | A megadott szolgáltató további frissítési neve nem importálható. | Elérte az IoT Hub eszközfrissítési példányában engedélyezett különböző nevek számát. Töröljön néhány frissítést a példányból, és próbálkozzon újra. |
| Hiba történt a frissítés importálásakor a túllépett korlát miatt. | A megadott szolgáltatóhoz és névhez nem importálható további frissítési verzió. | Elérte az IoT Hub eszközfrissítési példányában engedélyezett különböző verziók számát egy szolgáltató és egy név alatt. Törölje az ilyen nevű frissítéseket a példányból, és próbálkozzon újra. |
| Hiba történt a frissítés importálásakor a túllépett korlát miatt. | Nem importálható további frissítésszolgáltató a megadott kompatibilitással. vagy Nem importálható további frissítési név a megadott kompatibilitással. vagy Nem importálható további frissítési verzió a megadott kompatibilitással. |
Az importálási jegyzékben szereplő kompatibilitási tulajdonságok meghatározásakor vegye figyelembe, hogy az IoT Hub eszközfrissítése egyetlen szolgáltatót és névkombinációt támogat egy adott kompatibilitási tulajdonságkészlethez. Ha ugyanazt a kompatibilitási tulajdonságot egynél több szolgáltató/név kombinációval próbálja használni, ezeket a hibákat fogja látni. A probléma megoldásához győződjön meg arról, hogy egy adott eszköz (a kompatibilitási tulajdonságok által meghatározott) összes frissítése ugyanazt a szolgáltatót és nevet használja. |
| CannotProcessUpdateFile | Hiba a forrásfájl feldolgozásakor. | |
| ContentFileCannotDownload | A forrásfájl nem tölthető le. | Ellenőrizze, hogy a frissítési fájl(ok) URL-címe továbbra is érvényes-e. |
| SourceFileMalwareDetected | Egy importált fájlban ismert kártevő-aláírást észleltek. | Az IoT Hub eszközfrissítése több különböző mechanizmus használatával ellenőrzi az importált tartalmakat a kártevőkkel szemben. Ha egy ismert kártevő-aláírást azonosít, az importálás meghiúsul, és egy egyedi hibaüzenet jelenik meg. A hibaüzenet tartalmazza a kártevő-aláírás leírását, valamint egy fájlkivonatot minden olyan fájlhoz, ahol az aláírást észlelték. A fájlkivonat használatával megkeresheti a megjelölt fájlt, és a kártevő-aláírás leírásával ellenőrizheti, hogy a fájl kártevő-e. Miután eltávolította a kártevőt az importált fájlokból, újra elindíthatja az importálási folyamatot. |
| SourceFilePendingMalwareAnalysis | Az importált fájlban aláírást észleltek, amely azt jelezheti, hogy kártevő található. | Az IoT Hub eszközfrissítése több különböző mechanizmus használatával ellenőrzi az importált tartalmakat a kártevőkkel szemben. Az importálás meghiúsul, ha a vizsgálat aláírása rendelkezik a kártevők jellemzőivel, még akkor is, ha nincs pontos egyezés az ismert kártevőkkel. Ha ez történik, a rendszer egyedi hibaüzenetet ad vissza. A hibaüzenet tartalmazza a kártevőgyanús aláírás leírását, valamint minden olyan fájl kivonatát, amelyben az aláírást észlelték. A fájlkivonat használatával megkeresheti a megjelölt fájlt, és a kártevő-aláírás leírásával ellenőrizheti, hogy a fájl kártevő-e. Miután eltávolította a kártevőt az importált fájlokból, újra elindíthatja az importálási folyamatot. Ha biztos abban, hogy a fájlok kártevőmentesek, és továbbra is látni fogja ezt a hibát, használja a Kapcsolatfelvétel Microsoft ügyfélszolgálata folyamatot. |