IoT Hub için Cihaz Güncelleştirmesi hata kodları
Bu belge, çeşitli Cihaz Güncelleştirmesi bileşenleri için bir hata kodları tablosu sağlar.
Hata kodları oluşturan iki birincil istemci tarafı bileşeni vardır: Cihaz Güncelleştirme aracısı ve Teslim İyileştirme aracısı. Hata kodları, Cihaz Güncelleştirme içerik hizmetinden de gelir.
Cihaz Güncelleştirme aracısı
ResultCode ve ExtendedResultCode
IoT Hub Core PnP arabirimi raporları ResultCode ve ExtendedResultCodeiçin Cihaz Güncelleştirmesi, hataları tanılamak için kullanılabilir. Cihaz Güncelleştirmesi Çekirdek PnP arabirimi hakkında daha fazla bilgi için bkz. Cihaz Güncelleştirmesi ve Tak ve Kullan. Device Update aracısı ResultCode ve ExtendedResultCodes'un varsayılan anlamlarıyla ilgili daha fazla ayrıntı için Bkz . Cihaz Güncelleştirmesi GitHub deposu.
ResultCode genel durum kodudur ve ExtendedResultCode kodlanmış hata bilgilerini içeren bir tamsayıdır.
, ExtendedResultCode PnP arabiriminde imzalı bir tamsayı olarak görünür. kodunu ExtendedResultCodeçözmek için, imzalı tamsayıyı işaretsiz onaltılık değere dönüştürün. yalnızca ilk 4 bayt ExtendedResultCode kullanılır ve ilk parçanın Tesis Kodu olduğu ve bitlerin geri kalanı Hata Kodu biçimindedirFFFFFFFF.
Tesis Kodları
| Tesis Kodu | Açıklama |
|---|---|
| D | DO SDK'dan hata oluştu |
| E | Hata kodu bir hata kodudur |
Örneğin:
ExtendedResultCode-536870781
öğesinin işaretsiz onaltılık -536870781 gösterimidir FFFFFFFF E0000083.
| Yoksay | Tesis Kodu | Hata Kodu |
|---|---|---|
| FFFFFFFF | E | 0000083 |
0x83 onaltılıkta ondalık değeridir 131 ; bu, için ENOLCKerrno değeridir.
Teslim İyileştirme aracısı
Aşağıdaki tabloda, Cihaz Güncelleştirmesi istemcisinin Teslim İyileştirme (DO) bileşeniyle ilgili hata kodları listelenmektedir. DO bileşeni, güncelleştirme içeriğini IoT cihazına indirmekle sorumludur.
BIR API çağrısına yanıt olarak oluşan özel durumlar incelenerek DO hata kodu elde edilebilir. Tüm DO hata kodları 0x80D0 ön eki ile tanımlanabilir.
| Hata Kodu | Dize Hatası | Type | Açıklama |
|---|---|---|---|
| 0x80D01001L | DO_E_NO_SERVICE | yok | Teslim İyileştirme hizmeti sağlayamadı |
| 0x80D02002L | DO_E_DOWNLOAD_NO_PROGRESS | İşi İndir | Bir dosyanın indirilmesi tanımlı süre içinde ilerleme görmedi |
| 0x80D02011L | DO_E_UNKNOWN_PROPERTY_ID | İşi İndir | Bilinmeyen özellik kimliğiyle çağrılan SetProperty() veya GetProperty() |
| 0x80D02012L | DO_E_READ_ONLY_PROPERTY | İşi İndir | Salt okunur bir özellikte SetProperty() çağrılamıyor |
| 0x80D02013L | DO_E_INVALID_STATE | İşi İndir | İstenen eyleme geçerli iş durumunda izin verilmiyor. İş iptal edilmiş veya aktarımı tamamlanmış olabilir. Şu anda salt okunur durumda. |
| 0x80D02018L | DO_E_FILE_DOWNLOADSINK_UNSPECIFIED | İşi İndir | İndirme havuzu (yerel dosya veya akış arabirimi) belirtilmediğinden indirme başlatılamıyor |
| 0x80D02200L | DO_E_DOWNLOAD_NO_URI | IDOİndir Arabirimi | İndirme işlemi bir URI sağlanmadan başlatıldı |
| 0x80D03805L | DO_E_BLOCKED_BY_NO_NETWORK | Geçici koşullar | Ağ bağlantısı kaybı nedeniyle indirme duraklatıldı |
0 00 00000 Total 4 bytes (32 bits)
- -- -----
| | |
| | |
| | +--------- Error code (20 bits)
| |
| +------------- Component/Area code (8 bits)
|
+--------------- Facility code (4 bits)
Kodları ayrıştırma hakkında daha fazla bilgi için bkz . Cihaz Güncelleştirme Aracısı sonuç kodları ve genişletilmiş sonuç kodları veya özel İçerik İşleyicisi uygulama.
Cihaz Güncelleştirme içerik hizmeti
Aşağıdaki tabloda, Cihaz Güncelleştirme hizmetinin içerik hizmeti bileşeniyle ilgili hata kodları listelenmektedir. İçerik hizmeti bileşeni, güncelleştirme içeriğini içeri aktarmakla sorumludur. Ara sunucu güncelleştirmelerini içeri aktarmak için daha fazla sorun giderme bilgisi de sağlanır.
| Hata kodu | Dize hatası | Sonraki adımlar |
|---|---|---|
| UpdateAlreadyExists | Aynı kimlikle güncelleştirme zaten var. | IoT Hub için Cihaz Güncelleştirmesi örneğine henüz aktarılmamış bir güncelleştirmeyi içeri aktardığınızdan emin olun. |
| DuplicateContentImport | Aynı içerik aynı anda birden çok kez içeri aktarılır. | IoT Hub için Cihaz Güncelleştirmesi örneğine henüz aktarılmamış bir güncelleştirmeyi içeri aktardığınızdan emin olun. |
| CannotProcessImportManifest | İçeri aktarma bildirimi işlenirken hata oluştu. | Uygun içeri aktarma bildirimi biçimlendirmesi için içeri aktarma kavramları ve içeri aktarma güncelleştirme belgelerine bakın. |
| İndirilemiyor | İçeri aktarma bildirimi indirilemiyor. | İçeri aktarma bildirimi dosyasının URL'sinin hala geçerli olduğundan emin olun. |
| Ayrıştırılamıyor | İçeri aktarma bildirimi ayrıştırılamıyor. | İçeri aktarma güncelleştirme belgelerinde tanımlanan şemaya göre içeri aktarma bildiriminizin doğruluğunu denetleyin. |
| UnsupportedVersion | bildirim şeması sürümünü içeri aktarma desteklenmez. | İçeri aktarma bildiriminizin, içeri aktarma güncelleştirme belgelerinde tanımlanan en son şemayı kullandığından emin olun. |
| Sınırı aşıldığından güncelleştirme içeri aktarılırken hata oluştu. | Ek güncelleştirme sağlayıcısı içeri aktarılamıyor. | IoT Hub için Cihaz Güncelleştirmesi örneğinizde izin verilen farklı sağlayıcı sayısı sınırına ulaştınız. Örneğinizden bazı güncelleştirmeleri silin ve yeniden deneyin. |
| Sınırı aşıldığından güncelleştirme içeri aktarılırken hata oluştu. | Belirtilen sağlayıcı için ek güncelleştirme adı içeri aktarılamıyor. | IoT Hub için Cihaz Güncelleştirmesi örneğinizdeki bir sağlayıcı altında izin verilen farklı ad sayısı sınırına ulaştınız. Örneğinizden bazı güncelleştirmeleri silin ve yeniden deneyin. |
| Sınırı aşıldığından güncelleştirme içeri aktarılırken hata oluştu. | Belirtilen sağlayıcı ve ad için ek güncelleştirme sürümü içeri aktarılamıyor. | IoT Hub için Cihaz Güncelleştirmesi örneğinizde bir sağlayıcı ve ad altında izin verilen farklı sürüm sayısı sınırına ulaştınız. Örneğinizden bu ada sahip bazı güncelleştirmeleri silin ve yeniden deneyin. |
| Sınırı aşıldığından güncelleştirme içeri aktarılırken hata oluştu. | Belirtilen uyumlulukla ek güncelleştirme sağlayıcısı içeri aktarılamıyor. veya Belirtilen uyumlulukla ek güncelleştirme adı içeri aktarılamıyor. veya Belirtilen uyumlulukla ek güncelleştirme sürümü içeri aktarılamıyor. |
İçeri aktarma bildiriminde uyumluluk özelliklerini tanımlarken, IoT Hub için Cihaz Güncelleştirmesi'nin belirli bir uyumluluk özellikleri kümesi için tek bir sağlayıcı ve ad bileşimini desteklediğini unutmayın. Aynı uyumluluk özelliklerini birden fazla sağlayıcı/ad bileşimiyle kullanmaya çalışırsanız, bu hataları görürsünüz. Bu sorunu çözmek için, belirli bir cihaz için tüm güncelleştirmelerin (uyumluluk özellikleri tarafından tanımlandığı gibi) aynı sağlayıcıyı ve adı kullandığından emin olun. |
| CannotProcessUpdateFile | Kaynak dosya işlenirken hata oluştu. | |
| ContentFileCannotDownload | Kaynak dosya indirilemiyor. | Güncelleştirme dosyalarının URL'sinin hala geçerli olduğundan emin olun. |
| SourceFileMalware Algılandı | İçeri aktarılan bir dosyada bilinen bir kötü amaçlı yazılım imzası algılandı. | IoT Hub için Cihaz Güncelleştirmesi, çeşitli mekanizmalar kullanarak içeri aktarılan içeriği kötü amaçlı yazılımlara karşı tarar. Bilinen bir kötü amaçlı yazılım imzası tanımlanırsa içeri aktarma başarısız olur ve benzersiz bir hata iletisi döndürülür. Hata iletisi kötü amaçlı yazılım imzasının açıklamasını ve imzanın algılandığı her dosya için bir dosya karması içerir. Tam olarak bayrak eklenmiş dosyayı bulmak için dosya karmasını kullanabilir ve kötü amaçlı yazılım imzasının açıklamasını kullanarak bu dosyayı kötü amaçlı yazılım olup olmadığını kontrol edebilirsiniz. İçeri aktarılan tüm dosyalardan kötü amaçlı yazılımı kaldırdıktan sonra içeri aktarma işlemini yeniden başlatabilirsiniz. |
| SourceFilePendingMalwareAnalysis | İçeri aktarılan bir dosyada kötü amaçlı yazılım olduğunu gösterebilecek bir imza algılandı. | IoT Hub için Cihaz Güncelleştirmesi, çeşitli mekanizmalar kullanarak içeri aktarılan içeriği kötü amaçlı yazılımlara karşı tarar. Tarama imzasının kötü amaçlı yazılım özellikleri varsa, bilinen kötü amaçlı yazılımla tam olarak eşleşmese bile içeri aktarma işlemi başarısız olur. Bu durum oluştuğunda, benzersiz bir hata iletisi döndürülür. Hata iletisi, şüpheli kötü amaçlı yazılım imzasının açıklamasını ve imzanın algılandığı her dosya için bir dosya karması içerir. Tam olarak bayrak eklenmiş dosyayı bulmak için dosya karmasını kullanabilir ve kötü amaçlı yazılım imzasının açıklamasını kullanarak bu dosyayı kötü amaçlı yazılım olup olmadığını kontrol edebilirsiniz. İçeri aktarılan tüm dosyalardan kötü amaçlı yazılımı kaldırdıktan sonra içeri aktarma işlemini yeniden başlatabilirsiniz. Dosyalarınızın kötü amaçlı yazılım içermediğini düşünüyorsanız ve bu hatayı görmeye devam ediyorsanız Kişi Microsoft Desteği işlemini kullanın. |