Azure IoT Hub hata kodlarıyla ilgili sorunları giderme

Bu makalede, IoT Hub kullanırken karşılaşabileceğiniz yaygın hata kodlarının nedenleri ve çözümleri açıklanmaktadır.

400xxx Hatalı istek hataları

IoT Hub'a yönelik isteklerinizin 400 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
400000 GenericBadRequest Genel bir hatalı istek hatası. İstek biçimini ve parametrelerini denetleyin.
400001 InvalidProtocolVersion İstekte belirtilen protokol sürümü desteklenmez. Desteklenen bir protokol sürümünü kullanmak için isteği güncelleştirin.
400002 CihazGeçersizSonuçSayısı Cihaz tarafından döndürülen sonuç sayısı geçersiz. Cihazın doğru sayıda sonuç döndürdüğünden emin olun.
400003 InvalidOperation İstenen işlem geçerli değil. İşlemin cihaz için desteklendiğini doğrulayın.
400004 ArgumentInvalid İstekteki bir veya daha fazla parametre geçersiz. İstek parametrelerinin doğruluğunu kontrol edin.
400005 ArgumentNull Bir veya daha fazla gerekli bağımsız değişken boş. Tüm gerekli bağımsız değişkenlerin sağlandığından emin olun.
400006 IotHubFormatError İsteğin biçimi geçerli değil. Doğruluk için istek biçimini denetleyin.
400007 CihazDepolamaÖgesiSerileştirmeHatası Cihaz depolama nesnesi serileştirilemedi veya serileştirmeden çıkarılamadı. Serileştirme biçimini ve verilerini doğrulayın.
400008 BlobContainerValidationError Belirtilen blob kapsayıcısı geçerli değil. Blob kapsayıcısının adını ve izinlerini denetleyin.
400009 ImportWarningExistsError Mevcut bir içeri aktarma uyarısı var. İthalat uyarılarını inceleyin ve bunları ele alın.
400010 GeçersizŞemaSürümü Belirtilen şema sürümü geçerli değil. Şema sürümünü desteklenen bir sürüme güncelleştirin.
400011 DeviceDefinedMultipleTimes Cihaz birden çok kez tanımlanır. Cihazın yalnızca bir kez tanımlandığından emin olun.
400012 DeserializationError (Serileştirme Hatası) İstek seri durumdan çıkarılırken bir hata oluştu. İstek biçimini ve verileri doğru olup olmadığını denetleyin.
400013 Toplu Kayıt İşlemi Başarısızlığı Toplu kayıt işlemi başarısız oldu. Toplu işlem ayrıntılarını gözden geçirin ve yeniden deneyin.
400014 DefaultStorageEndpointNotConfigured Varsayılan depolama uç noktası yapılandırılmamış. Varsayılan depolama uç noktasını yapılandırın.
400015 InvalidFileUploadCorrelationId Dosya yükleme ilişkilendirme kimliği geçerli değil. Dosya yükleme ilişkilendirme kimliğinin doğru olduğunu kontrol edin.
400016 Süresi Geçmiş Dosya Yükleme Bağlantı Kimliği (ExpiredFileUploadCorrelationId) Dosya karşıya yükleme bağıntı kimliğinin süresi doldu. Yeni bir dosya yükleme korrelasyon kimliği edinin.
400017 InvalidStorageEndpoint Belirtilen depolama uç noktası geçerli değil. Depolama uç noktasının doğruluğuna bakın.
InvalidMessagingEndpoint 400018 Belirtilen mesajlaşma uç noktası geçerli değil. Doğru bilgi için mesajlaşma uç noktasını denetleyin.
InvalidFileUploadCompletionStatus 400019 Dosya yükleme tamamlanma durumu geçersiz. Dosya yüklemesinin tamamlanma durumunun doğru olduğundan emin olun.
400020 Geçersiz Depolama Uç Noktası veya Blob (InvalidStorageEndpointOrBlob) Dosya karşıya yükleme sırasında blob oluşturmaya çalışırken, blob depolama alanı ya Forbidden, Unauthorized, NotFound veya BadRequest ile yanıt verir. Blob depolama izinlerini ve varlığını denetleyin.
400021 RequestCanceled İstek iptal edildi. İsteği yeniden deneyin.
400022 Geçersiz Depolama Uç Noktası Özelliği Belirtilen depolama uç noktası özelliği geçerli değil. Doğruluğu için depolama uç noktası özelliklerini denetleyin.
400023 EtagDoesNotMatch İstekte belirtilen ETag, kaynağın geçerli ETag'iyle eşleşmiyor. İstekteki ETag'i geçerli ETag ile eşleşecek şekilde güncelleştirin.
requestTimedOut 400024 İstek zaman aşımına uğradı. İsteği yeniden deneyin.
400025 Kopya Üzerinde Desteklenmeyen İşlem İşlem belirtilen replika üzerinde desteklenmiyor. İşlem ve çoğaltma ayrıntılarını gözden geçirin.
400026 BoşMesaj Mesaj boş. İletinin null olmadığından emin olun.
400027 Yeni Bağlantıda Zorlama Bağlantı Kesildi Cihazınızın bağlantısı kesilir ve Communication_Error, ConnectionStatusChangeReason olarak .NET SDK ve MQTT aktarım türünü kullanarak bildirir. Cihazdan buluta ikiz işleminiz (raporlanan özelliklerin okunması veya yamalanması gibi) ya da doğrudan yöntem çağrısı, hata kodu 400027 ile başarısız oluyor. Bu hata, başka bir istemci aynı kimliği kullanarak IoT Hub'a yeni bir bağlantı oluşturduğunda oluşur, bu nedenle IoT Hub önceki bağlantıyı kapatır. IoT Hub'ı birden fazla istemcinin aynı kimliği kullanarak bağlanmasına izin vermez. Her istemcinin kendi kimliğini kullanarak IoT Hub'a bağlandığından emin olun.
400028 InvalidDeviceScope Belirtilen cihaz kapsamı geçerli değil. Cihaz kapsamının doğruluğunu denetleyin.
400029 ConnectionForcefullyClosedOnFaultInjection Hizmet ve platform yükseltmeleri sırasında mevcut bağlantılar bu hatayla kapatılır. Yeniden denemelerin hemen başarılı olması beklenir. İşlemi yeniden deneyin
400030 BağlantıHataEnjeksiyonundaReddedildi Hizmet ve platform yükseltmeleri sırasında yeni bağlantılar ve hemen yeniden deneme girişimleri bu hatayla reddedilir. İşlemi yeniden deneyin
InvalidEndpointAuthenticationType 400031 Belirtilen uç nokta kimlik doğrulama türü geçerli değil. Doğruluk için uç nokta kimlik doğrulama türünü denetleyin.
400032 YönetilenKimlikEtkinDeğil Yönetilen kimlik etkinleştirilmedi. Yönetilen kimliği etkinleştirin.
400035 InvalidPolicyKey Belirtilen ilke anahtarı geçerli değil. Politika anahtarının doğruluğunu kontrol edin.
400036 TopluCihazAnahtarınıYenidenÜretmeİşlemiBaşarısızlığı Cihaz anahtarının toplu yeniden oluşturma işlemi başarısız oldu. İşlem ayrıntılarını gözden geçirin.

4001xx Yönlendirme hataları

IoT Hub'a yönelik isteklerinizin 4001 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
400100 InvalidRouteTestInput Belirtilen yol testi girişi geçerli değil. Rota testi girişinde doğruluk olup olmadığını denetleyin.
InvalidSourceOnRoute 400101 Yolda belirtilen kaynak geçerli değil. Doğru olup olmadığını kontrol etmek için rotadaki kaynağı denetleyin.
400102 YönlendirmeEtkinDeğil Yönlendirme etkin değil. Yönlendirmeyi etkinleştirin.
400103 InvalidContentEncodingOrType Belirtilen içerik kodlaması veya türü geçerli değil. İçerik kodlamasını veya türünü doğru olup olmadığını denetleyin.

4003xx Modül hataları

IoT Hub'a yönelik isteklerinizin 4003 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
400301 CannotRegisterModuleToModule - Modül diğer bir modüle kayıt olamıyor. Modülden modüle iletişim desteklenmez. Bunun yerine cihazdan buluta veya buluttan cihaza iletişimi kullanın.
400302 TenantHubRoutingNotEnabled Kiracı hub yönlendirmesi etkin değil. Kiracı merkez yönlendirmesini etkinleştirin.

4004xx Yapılandırma hataları

IoT Hub'a yönelik isteklerinizin 4004 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
InvalidConfigurationTargetCondition 400401 Yapılandırmada belirtilen hedef koşul geçerli değil. Doğruluk için hedef koşulu denetleyin.
InvalidConfigurationContent 400402 Yapılandırmada belirtilen içerik geçerli değil. Yapılandırma içeriğinin doğruluğunu denetleyin.
400403 Değiştirilemez Yapılandırma İçeriği Değiştirilemez Yapılandırma içeriği sabittir ve değiştirilemez. Bunun yerine yeni bir yapılandırma oluşturun.
400404 GeçersizYapılandırmaÖzelMetrikSorgusu Yapılandırmada belirtilen özel ölçüm sorgusu geçerli değil. Doğruluk için özel ölçümler sorgusunu denetleyin.

4005xx Dijital ikiz arabirim hataları

IoT Hub'a yönelik isteklerinizin 4005 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
400501 InvalidPnPInterfaceDefinition Belirtilen arabirim tanımı geçerli değil. Doğru olup olmadığını denetlemek için arabirim tanımını denetleyin.
400502 InvalidPnPDesiredProperties Belirtilen istenen özellikler geçerli değil. Doğruluk için istenen özellikleri denetleyin.
InvalidPnPReportedProperties 400503 Belirtilen özellikler geçerli değil. Bildirilen özelliklerin doğruluğunu denetleyin.
InvalidPnPWritableReportedProperties 400504 Belirtilen bildirilen yazılabilir özellikler geçerli değil. Yazılabilir bildirilen özelliklerin doğru olduğundan emin olun.
InvalidDigitalTwinJsonPatch 400505 Dijital ikiz için belirtilen JSON düzeltme eki geçerli değil. Doğru olup olmadığını görmek için JSON düzeltme ekini denetleyin.
400506 InvalidDigitalTwinPayload Dijital ikiz için belirtilen yük geçerli değil. Doğruluk için dijital ikiz yükünü denetleyin.
InvalidDigitalTwinPatch 400507 Dijital ikiz için belirtilen yama geçerli değil. Doğruluk için dijital ikiz yamasını denetleyin.
InvalidDigitalTwinPatchPath 400508 Dijital ikiz için belirtilen yama yolu geçerli değil. Doğru olup olmadığını görmek için dijital ikiz yama yolunu denetleyin.

401xxx Yetkisiz hatalar

IoT Hub'a yönelik isteklerinizin 401 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
401000 GenericUnauthorized İstek yetkilendirilmemiş. Yetkilendirme kimlik bilgilerini denetleyin.
401001 IotHubNotFound Belirtilen IoT Hub bulunamadı. IoT Hub adını ve bölgesini denetleyin.
401002 IotHubUnauthorizedAccess İstek, IoT Hub'a erişim yetkisine sahip değil. IoT Hub'ın erişim ilkelerini ve izinlerini denetleyin.
401003 IotHubUnauthorized (IotHub Yetkisiz) İstek, IoT Hub'a erişim yetkisine sahip değil. Daha fazla bilgi için bkz. 401003 IotHubUnauthorized hatası.
401004 ElasticPoolNotFound Belirtilen elastik havuz bulunamadı. Elastik havuz adını ve bölgesini kontrol edin.
401100 SystemModuleModifyUnauthorizedAccess - Sistem Modülünü Yetkisiz Erişimle Değiştirme Sistem modülü kaynağı değiştirme yetkisine sahip değil. Sistem modülünün izinlerini denetleyin.

401003 IoT Hub Yetkisiz hatası

Günlüklerde, cihazların 401003 IoTHubUnauthorized ile bağlantısının kesilmesi ve ardından 404104 DeviceConnectionClosedRemotely ile kısa bir süre sonra başarıyla bağlanmaları düzenini görebilirsiniz.

Veya IoT Hub istekleri aşağıdaki hata iletilerinden biriyle başarısız olur:

  • Yetkilendirme üst bilgisi eksik
  • IotHub '*' belirtilen '*' cihazını içermiyor
  • Yetkilendirme kuralı '*' '*' için erişime izin vermiyor
  • Bu cihaz için kimlik doğrulama başarısız oldu, belirteç veya sertifikayı yenileyip yeniden bağlanın
  • Parmak izi yapılandırmayla eşleşmiyor: Parmak izi: SHA1Hash=*, SHA2Hash=*; Yapılandırma: PrimaryThumbprint=*, SecondaryThumbprint=*
  • Atanmış izinlerin olmaması yüzünden kullanıcı user@example.com /exampleOperation üzerinde GET için yetkili değil.

Bu hata, MQTT için bazı SDK'ların, SAS belirteci süresi dolduğunda bağlantının kesilmesini sağlamak amacıyla yenileme zamanını belirlemek için IoT Hub'a güvenmesinden dolayı meydana gelir. Öyle:

  1. SAS belirtecinin süresi doluyor
  2. IoT Hub süre sonunu fark eder ve cihazın bağlantısını 401003 IoTHubUnauthorized üzerinde keser.
  3. Cihaz bağlantı kesilmesini şu şekilde tamamlar: 404104 DeviceConnectionClosedRemotely
  4. IoT SDK'sı yeni bir SAS belirteci oluşturur
  5. Cihaz IoT Hub'a başarıyla yeniden bağlanıyor

Veya IoT Hub kimlik doğrulama üst bilgisini, kuralı veya anahtarı doğrulayamadı. Bu sonuç, belirtilerde belirtilen nedenlerden herhangi birine bağlı olabilir.

Bu hatayı çözmek için cihaz bağlantı dizesini kullanarak bağlantı için IoT SDK'sı kullanılıyorsa hiçbir eylem gerekmez. IoT SDK, SAS belirteci süre sonuyla yeniden bağlanmak için yeni belirteci yeniden oluşturur.

Varsayılan belirteç ömrü SDK'lar arasında 60 dakikadır; ancak bazı SDK'lar için belirteç ömrü ve belirteç yenileme eşiği yapılandırılabilir. Buna ek olarak, bir cihaz bağlantı kesildiğinde ve belirteç yenileme sırasında yeniden bağlandığında oluşturulan hatalar her SDK için farklılık gösterir. Daha fazla bilgi edinmek ve cihazınızın günlüklerde hangi SDK'yı kullandığını belirleme hakkında bilgi için Azure IoT Hub cihaz bağlantısını izleme, tanılama ve sorunlarını giderme makalesinin Azure IoT SDK'ları ile MQTT cihaz bağlantı kesme davranışı bölümüne bakın.

Cihaz geliştiricileri için hata hacmi önemliyse, süre dolmadan önce SAS belirtecini yenileyen C SDK'sına geçin. AMQP için SAS belirteci bağlantı kesilmeden yenilenebilir.

Genel olarak, sunulan hata iletisi hatanın nasıl düzeltileceğini açıklamalıdır. Bazı nedenlerden dolayı hata iletisi ayrıntılarına erişiminiz yoksa şunlardan emin olun:

  • Kullandığınız SAS veya diğer güvenlik belirtecinin süresi dolmaz.
  • X.509 sertifika kimlik doğrulaması için cihaz sertifikasının veya cihazla ilişkili CA sertifikasının süresi dolmaz. X.509 CA sertifikalarını IoT Hub'a kaydetmeyi öğrenmek için Test için sertifika oluşturma ve karşıya yükleme eğitimini inceleyin.
  • X.509 sertifikası parmak izi kimlik doğrulaması için cihaz sertifikasının parmak izi IoT Hub'a kaydedilir.
  • Kullandığınız protokol için yetkilendirme kimlik bilgileri iyi biçimlendirilmiş. Daha fazla bilgi edinmek için bkz. Microsoft Entra Id kullanarak IoT Hub'a erişimi denetleme.
  • Kullanılan yetkilendirme kuralı, istenen işlem için izinlere sahiptir.
  • "Sorumlu..." ile başlayan son hata iletileri için, kullanıcıya doğru Azure RBAC izni düzeyi atanarak bu hata çözülebilir. Örneğin, IoT Hub'ındaki bir Sahip tüm izinleri veren "IoT Hub Veri Sahibi" rolünü atayabilir. İzin eksikliği sorununu çözmek için bu rolü deneyin.

Uyarı

Bazı cihazlarda, cihaz saatinin sunucu süresinden beş dakikadan uzun bir fark olması durumunda zaman kayma sorunuyla karşılaşılabilir. Bu hata, bir cihaz bir IoT hub'ına haftalarca ve hatta aylar boyunca sorunsuz bir şekilde bağlandığında ancak bağlantısının sürekli reddedilmesine neden olduğunda oluşabilir. Hata ioT hub'ına bağlı cihazların bir alt kümesine de özgü olabilir, çünkü bir cihazın ilk bağlandığı veya açılacağı zamana bağlı olarak zaman kayma farklı hızlarda gerçekleşebilir.

Genellikle, NTP kullanarak bir zaman eşitlemesi gerçekleştirmek veya cihazı yeniden başlatmak (önyükleme sırası sırasında otomatik olarak bir zaman eşitlemesi gerçekleştirebilir) sorunu giderir ve cihazın yeniden bağlanmasına izin verir. Bu hatayı önlemek için, cihazı NTP kullanarak düzenli bir zaman eşitlemesi gerçekleştirecek şekilde yapılandırın. Cihaz deneyimlerinin kayma miktarına bağlı olarak eşitlemeyi günlük, haftalık veya aylık olarak zamanlayabilirsiniz. Cihazınızda düzenli bir NTP eşitlemesi yapılandıramıyorsanız düzenli bir yeniden başlatma zamanlayın.

403xxx Yasak hataları

IoT Hub'a yönelik isteklerinizin 403 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
403000 GenericForbidden İstek yasaktır. İstek izinlerini denetleyin.
403001 IotHubSuspended IoT Hub askıya alındı. IoT Hub durumunu denetleyin.
403002 IotHubQuotaExceeded IoT Hub kotası aşıldı. Daha fazla bilgi için bkz. 403002 IotHubQuotaExceeded Hatası.
403003 İş Kotası Aşıldı İş kotası aşıldı. İş kotalarını ve sınırlarını denetleyin.
403004 Cihaz Maksimum Kuyruk Derinliği Aşıldı Cihazın en yüksek kuyruk derinliği aşıldı. Daha fazla bilgi için 403004 DeviceMaximumQueueDepthExceeded hatası'na bakın.
403005 IotHubMaxCbsTokenExceeded IoT Hub maksimum CBS belirteci sınırı aşıldı. IoT Hub CBS belirteci sınırlarını denetleyin.
403006 Cihazın Maksimum Aktif Dosya Yükleme Limiti Aşıldı Cihaz etkin dosya yükleme sınırı üst sınırı aşıldı. Daha fazla bilgi için 403006 DeviceMaximumActiveFileUploadLimitExceeded hatası bölümüne bakın.
403007 CihazMaksimumKuyrukBoyutuAşıldı Cihazın maksimum kuyruk boyutu aşıldı. Cihaz kuyruğu boyutunu denetleyin.
403008 RoutingEndpointResponseForbidden (Yönlendirme Uç Noktası Yanıtı Yasak) Yönlendirme uç noktası yanıtı engellendi. Yönlendirme uç noktası izinlerini denetleyin.
403009 InvalidMessageExpiryTime İletinin geçerlilik süresi geçersiz. İletinin süre sonu ayarlarını denetleyin.
403010 Mevcut Seviyede Kullanılamayan İşlem Geçerli katmandaki bu işlem mevcut değildir. IoT Hub katmanını ve özelliklerini denetleyin.
403011 Anahtar Şifreleme Anahtarı İptal Edildi Anahtar şifreleme anahtarı iptal edildi. Anahtar şifreleme anahtarı durumunu denetleyin.
403012 DeviceDisabled Cihaz devre dışı bırakıldı. Cihaz durumunu denetleyin.
403800 Cihaz Maksimum Uçuş Yöntemi Aşıldı Cihazın maksimum uçuş sırasındaki yöntem sınırı aşıldı. Cihazın uçuş sırasında metod sınırlarını denetleyin.

403002 IotHubQuotaExceeded hatası

IoT Hub'a yönelik isteklerin, 403002 IotHubQuotaExceeded hatasıyla başarısız olduğunu görebilirsiniz. Azure portalında IoT hub cihaz listesi yüklenmez.

Bu hata genellikle IoT hub'ı için günlük ileti kotası aşıldığında oluşur. Bu hatayı düzeltmek için:

Toplu veri aktarma işlemi, IoT hub'ınıza kayıtlı cihaz sayısı bir IoT hub'ı için kota sınırına yaklaştığında veya sınırı aştığında da bu hatayı döndürebilir. Daha fazla bilgi edinmek için İçeri aktarma işlerinin sorunlarını giderme bölümüne ve IoT Hub cihaz kimliklerini toplu olarak içeri ve dışarı aktarma kılavuzuna bakın.

403004 DeviceMaximumQueueDepthExceeded hatası

Cihaza bulut üzerinden bir mesaj göndermeye çalıştığınızda, isteğin 403004 veya DeviceMaximumQueueDepthExceeded hatasıyla başarısız olduğunu görebilirsiniz.

Bu hatanın temel nedeni, cihaz için sıraya alınan ileti sayısının kuyruk sınırını aşmasıdır.

Bu sınırla karşı karşıya kalmanızın en olası nedeni, iletiyi almak için HTTPS kullanmanızdır, bu da ReceiveAsync kullanarak sürekli yoklamalara yol açar ve IoT Hub'ın isteği kısıtlamasına neden olur.

HTTPS kullanan buluttan cihaza mesajlar için desteklenen desen, iletileri seyrek kontrol eden ara sıra bağlı olan cihazlardır (25 dakikadan az). Kuyruk sınırına geçme olasılığını azaltmak için buluttan cihaza iletiler için AMQP veya MQTT'ye geçin.

Alternatif olarak, kuyruğa alınan iletileri hızlı bir şekilde tamamlamak, reddetmek veya bırakmak, yaşam süresini kısaltmak veya daha az ileti göndermeyi göz önünde bulundurmak için cihaz tarafı mantığını geliştirin. Daha fazla bilgi için IoT hub'ından buluttan cihaza mesajlaşmayı anlama'nınİleti süre sonu (yaşam süresi) bölümüne bakın.

Son olarak, sınıra ulaşılmadan önce bekleyen iletileri düzenli aralıklarla temizlemek için Kuyruk Temizleme API'sini kullanmayı göz önünde bulundurun.

403006 DeviceMaximumActiveFileUploadLimitExceeded hatası

Dosya karşıya yükleme isteğinizin hata koduyla 403006 veya DeviceMaximumActiveFileUploadLimitExceeded "Etkin dosya yükleme isteği sayısı 10'u aşamaz" iletisiyle başarısız olduğunu görebilirsiniz.

Her cihaz istemcisi eşzamanlı dosya yükleme işlemleri için sınırlı olduğundan bu hata oluşur. Dosya yüklemeleri tamamlandığında cihazınız IoT Hub'a bildirim göndermezse sınırı kolayca aşabilirsiniz. Güvenilir olmayan bir cihaz tarafı ağı genellikle bu soruna neden olur.

Bu hatayı düzeltmek için cihazın IoT Hub dosyasını karşıya yükleme işleminin tamamlandığını hemen bildirediğinden emin olun. Ardından, dosya yükleme yapılandırması için SAS belirteci TTL'sini azaltmayı deneyin.

4031xx Modeli yasaklanmış cihaz hataları

IoT Hub'a yönelik isteklerinizin 4031 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
403100 DeviceModelMaxPropertiesExceeded (Cihaz Modeli Maksimum Özellikleri Aşıldı) Cihaz modeli maksimum özellik sınırı aşıldı. Cihaz modeli özelliklerini denetleyin.
403101 CihazModeliMaksimumİndekslenebilirÖzellikAşıldı Cihaz modeli en fazla dizinlenebilir özellik sınırı aşıldı. Cihaz modelinin dizine eklenebilir özelliklerini denetleyin.

404xxx NotFound hata mesajları

IoT Hub'a yönelik isteklerinizin 404 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
404000 GenericNotFound İstenen kaynak bulunamadı. Kaynak kimliğini denetleyin ve yeniden deneyin.
404001 DeviceNotFound Belirtilen cihaz bulunamadı. Daha fazla bilgi için bkz. 404001 DeviceNotFound hatası .
404002 JobNotFound Belirtilen iş bulunamadı. İş kimliğini denetleyin ve yeniden deneyin.
404004 QuotaMetricNotFound Belirtilen kota ölçümü bulunamadı. Kota metrik kimliğini denetleyin ve yeniden deneyin.
404005 SystemPropertyNotFound Belirtilen sistem özelliği bulunamadı. Sistem özellik kimliğini denetleyin ve yeniden deneyin.
404006 AmqpAdresBulunamadı Belirtilen AMQP adresi bulunamadı. AMQP adresini denetleyin ve yeniden deneyin.
404007 RoutingEndpointResponseNotFound Belirtilen yönlendirme uç noktası yanıtı bulunamadı. Yönlendirme uç noktasını denetleyin ve yeniden deneyin.
404008 CertificateNotFound Belirtilen sertifika bulunamadı. Sertifika kimliğini denetleyin ve yeniden deneyin.
404009 ElasticPoolTenantHubNotFound Belirtilen Elastik Havuz Kiracı Hub'ı bulunamadı. Elastik Havuz Tenant Hub Kimliğini denetleyin ve yeniden deneyin.
404010 ModuleNotFound Belirtilen modül bulunamadı. Modül kimliğini denetleyin ve yeniden deneyin.
AzureTableStoreNotFound 404011 Belirtilen Azure Tablo Deposu bulunamadı. Azure Tablo Deposu Kimliğini denetleyin ve yeniden deneyin.
404012 IotHubFailingOver IoT Hub yedek sunucuya geçiyor. IoT Hub durumunu denetleyin ve yeniden deneyin.
404013 ÖzellikDesteklenmiyor İstenen özellik desteklenmiyor. Özellik belgelerini gözden geçirin ve yeniden deneyin.
404014 DigitalTwinInterfaceNotFound Belirtilen Dijital İkiz arabirimi bulunamadı. Dijital İkiz arabirim kimliğini denetleyin ve yeniden deneyin.

404001 DeviceNotFound hatası

Buluttan cihaza (C2D) iletişim sırasında, C2D iletisi, ikiz güncelleştirmesi veya doğrudan yöntem gibi işlemin 404001 DeviceNotFound hatasıyla başarısız olduğunu görebilirsiniz.

IoT Hub cihazı bulamadığından işlem başarısız oldu. Cihaz kayıtlı değil veya devre dışı.

Bu hatayı çözmek için kullandığınız cihaz kimliğini kaydedin ve yeniden deneyin.

4041xx Cihaz modeli NotFound hataları

IoT Hub'a yönelik isteklerinizin 4041 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
404101 QueryStoreClusterNotFound Belirtilen sorgu deposu kümesi bulunamadı. Sorgu deposu küme kimliğini denetleyin ve yeniden deneyin.
404102 DeviceNotOnline Belirtilen cihaz çevrimiçi değil. Daha fazla bilgi için bkz. 404103 DeviceNotOnline hatası .
404104 CihazBağlantısıUzaktanKapandı Cihaz bağlantısı uzaktan kapatıldı. Bkz. 404104 DeviceConnectionClosedRemotely hatası daha fazla bilgi için.

404103 DeviceNotOnline hatası

Cihaz çevrimiçi olsa bile bir cihaza yönelik doğrudan yöntemin hatayla 404103 DeviceNotOnline başarısız olduğunu görebilirsiniz.

Cihazın çevrimiçi olduğunu biliyorsanız ve hatayı almaya devam ediyorsanız, doğrudan yöntem geri çağırması cihazda kayıtlı olmadığından büyük olasılıkla hata oluştu.

Cihazınızı doğrudan yöntem geri çağırmaları için düzgün şekilde yapılandırma hakkında daha fazla bilgi için, Cihazda doğrudan yöntemi işleme bölümünün Cihazda doğrudan yöntemi işleme kısmına bakın.

404104 DeviceConnectionClosedRemotely hatası

Cihazların düzenli aralıklarla (örneğin, 65 dakikada bir) bağlantısının kesildiğini ve IoT Hub kaynak günlüklerinde gördüğünüzü görebilirsiniz 404104 DeviceConnectionClosedRemotely . Bazen 401003 IoTHubUnauthorized ve bir dakikadan kısa bir süre içinde başarılı bir cihaz bağlantısı olayı da görürsünüz.

Alternatif olarak, cihazların bağlantısı rastgele kesilir ve IoT Hub kaynak günlüklerinde görürsünüz 404104 DeviceConnectionClosedRemotely .

Ya da birçok cihazın bağlantısı aynı anda kesilir. Bağlı cihazlar (connectedDeviceCount) ölçümünde bir düşüş görürsünüz ve Azure İzleyici Günlüklerinde normalden daha fazla 404104 DeviceConnectionClosedRemotelyve 500xx dahili hata vardır.

IoT Hub'a bağlanmak için kullanılan SAS belirtecinin süresinin dolması nedeniyle bu hata oluşabilir ve bu da IoT Hub'ın cihazın bağlantısını kesmesine neden olur. Cihaz belirteci yenilediğinde bağlantı yeniden kurulur. Örneğin, C SDK'sı için SAS belirtecinin süresi varsayılan olarak her saat dolar ve bu da düzenli bağlantı kesintilerine neden olabilir. Daha fazla bilgi edinmek için bkz. IoTHubUnauthorized hatası 401003.

Diğer bazı olasılıklar şunlardır:

  • Cihaz , MQTT etkin tutma süresinden daha uzun süre dayanak ağ bağlantısını kaybederek uzak boşta kalma zaman aşımına neden oldu. MQTT canlı tutma ayarı cihaz başına farklı olabilir.
  • Cihaz TCP/IP düzeyinde bir sıfırlama gönderdi ancak uygulama düzeyi MQTT DISCONNECTgöndermedi. Temel olarak, cihaz aniden temel yuva bağlantısını kapattı. Bazen Azure IoT SDK'sının eski sürümlerindeki hatalar bu soruna neden olabilir.
  • Cihaz tarafı uygulaması çöktü.

Veya IoT Hub geçici bir sorun yaşıyor olabilir. Daha fazla bilgi için 500xxx Dahili Hatalar bölümüne bakın.

Bu hatayı düzeltmek için:

Uyarı

Bağlantıları güvenilir bir şekilde yönetmek için Azure IoT cihaz SDK'larını kullanmanızı öneririz. Daha fazla bilgi edinmek için bkz. Dayanıklı uygulamalar oluşturmak için cihaz yeniden bağlantılarını yönetme

4043xx Yapılandırma Bulunmadı hataları

IoT Hub'a yönelik isteklerinizin 4043 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
404301 YapılandırmaBulunamadı Belirtilen yapılandırma bulunamadı. Yapılandırma kimliğini denetleyin ve yeniden deneyin.
404302 GroupNotFound Belirtilen grup bulunamadı. Grup kimliğini denetleyin ve yeniden deneyin.

4044xx PnP NotFound hataları

IoT Hub'a yönelik isteklerinizin 4044 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
404401 DigitalTwinModelNotFound Belirtilen dijital ikiz modeli bulunamadı. Dijital ikiz model ID'sini kontrol edin ve yeniden deneyin.
404402 InterfaceNameModelNotFound Belirtilen arabirim adı modeli bulunamadı. Arabirim adı model kimliğini denetleyin ve yeniden deneyin.

405xxx MethodNotAllowed hataları

IoT Hub'a yönelik isteklerinizin 405 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
405000 GenericMethodNotAllowed Belirtilen yönteme izin verilmiyor. Yöntemini denetleyin ve yeniden deneyin.

4051xx Cihaz modeli MethodNotAllowed hataları

IoT Hub'a yönelik isteklerinizin 4051 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
405102 Geçerli Durumda İşlem İzin Verilmedi Geçerli durumda işleme izin verilmiyor. Cihaz durumunu denetleyin ve yeniden deneyin.
405103 Cihazların İçe Aktarılması Desteklenmiyor Cihazların içeri aktarılması desteklenmez. İçeri aktarma ayarlarını denetleyin ve yeniden deneyin.
405104 TopluCihazEklemeDesteklenmiyor Cihazların toplu şekilde eklenmesi desteklenmiyor. Toplu ekleme ayarlarını denetleyin ve yeniden deneyin.

409xxx Çakışma hataları

IoT Hub'a yönelik isteklerinizin 409 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
409000 GenelÇakışma Bir çakışma oluştu. İsteği denetleyin ve yeniden deneyin.
409001 CihazZatenVar Belirtilen cihaz zaten var. Daha fazla bilgi için bkz. 409001 DeviceAlreadyExists hatası .
409002 BağlantıOluşturmaÇakışması Bağlantı oluşturulurken bir çakışma oluştu. Daha fazla bilgi için bkz. 409002 LinkCreationConflict hatası .
409003 Geri Arama Abonelik Çakışması Callback aboneliğiyle bir çakışma oluştu. Geri arama aboneliği ayarlarını denetleyin ve yeniden deneyin.

409001 DeviceAlreadyExists hatası

IoT Hub'a bir cihaz kaydetmeye çalışırken isteğin hatasıyla 409001 DeviceAlreadyExistsbaşarısız olduğunu görebilirsiniz.

IoT hub'ında aynı cihaz kimliğine sahip bir cihaz zaten olduğundan bu hata oluşur.

Bu hatayı çözmek için farklı bir cihaz kimliği kullanın ve yeniden deneyin.

409002 LinkCreationConflict hatası

Günlüklerde, cihaz bağlantısının kesilmesi veya buluttan cihaza ileti hatasıyla birlikte 409002 LinkCreationConflict hatasını görebilirsiniz.

Bu hata genellikle IoT Hub bir istemcinin birden fazla bağlantısı olduğunu algıladığında oluşur. Aslında, mevcut bir bağlantıya sahip bir cihaz için yeni bir bağlantı isteği geldiğinde, IoT Hub mevcut bağlantıyı bu hatayla kapatır.

En yaygın durumda, ayrı bir sorun (404104 DeviceConnectionClosedRemotely hatası gibi) cihazın bağlantısının kesilmesine neden olur. Cihaz bağlantıyı hemen yeniden kurmaya çalışır, ancak IoT Hub yine de cihazın bağlı olduğunu düşünür. IoT Hub önceki bağlantıyı kapatır ve bu hatayı günlüğe kaydeder.

Ya da hatalı cihaz tarafı mantığı, zaten açık olan cihazın bağlantı kurmasına neden olur.

Bu hatayı çözmek için günlüklerde giderebileceğiniz diğer hataları arayın çünkü bu hata genellikle farklı, geçici bir sorunun yan etkisi olarak görünür. Aksi takdirde, yalnızca bağlantı bırakıldığında yeni bir bağlantı isteği göndermeyi unutmayın.

4091xx Cihaz modeli çakışma hataları

IoT Hub'a yönelik isteklerinizin 4091 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
409101 ModelAlreadyExists Belirtilen model zaten var. Model kimliğini denetleyin ve yeniden deneyin.
409102 DeviceLocked Belirtilen cihaz kilitli. Cihaz durumunu denetleyin ve yeniden deneyin.
409103 DeviceJobAlreadyExists Belirtilen cihaz görevi zaten mevcut. Cihaz iş kimliğini denetleyin ve yeniden deneyin.
409104 JobAlreadyExists Belirtilen iş zaten var. İş kimliğini denetleyin ve yeniden deneyin.

4093xx Modülleri çakışma hataları

IoT Hub'a yönelik isteklerinizin 4093 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
409301 CihazdaModülZatenVar Belirtilen modül cihazda zaten var. Modül kimliğini denetleyin ve yeniden deneyin.

4094xx Yapılandırma çakışma hataları

IoT Hub'a yönelik isteklerinizin 4094 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
409401 ConfigurationAlreadyExists Belirtilen yapılandırma zaten var. Yapılandırma kimliğini denetleyin ve yeniden deneyin.
409402 Cihazda Zaten Devam Eden Uygulama Yapılandırması Belirtilen yapılandırma uygulaması cihazda zaten devam ediyor. Cihaz durumunu denetleyin ve yeniden deneyin.

4095xx Dijital ikiz çakışma hataları

IoT Hub'a yönelik isteklerinizin 4095 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
409501 DijitalİkizModeliZatenVar Belirtilen dijital ikiz modeli zaten var. Dijital ikiz model ID'sini kontrol edin ve yeniden deneyin.
409502 DigitalTwinModelExistsWithOtherModelType (Diğer Model Türü ile Var Olan Dijital İkiz Model) Belirtilen dijital ikiz modeli farklı bir model türüyle var. Dijital ikiz model tipini kontrol edin ve tekrar deneyin.
409503 InterfaceNameModelAlreadyExists (Arayüz Adı Modeli Zaten Mevcut) Belirtilen arabirim adı modeli zaten var. Arabirim adı model kimliğini denetleyin ve yeniden deneyin.

412xxx ÖnkoşulBaşarısız hataları

IoT Hub'a yönelik isteklerinizin 412 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
412000 GenericPreconditionFailed Genel bir önkoşul başarısız oldu. İsteği denetleyin ve yeniden deneyin.
412001 PreconditionFailed Önkoşul başarısız oldu. İsteği denetleyin ve yeniden deneyin.
412002 Cihaz Mesaj Kilidi Kayboldu Cihaz ileti kilidi kayboldu. Daha fazla bilgi için bkz . DeviceMessageLockLost hatası 412002 .
412003 İşletim Önkoşulu Başarısız Oldu Görev yürütme önkoşulu başarısız oldu. İş durumunu denetleyin ve yeniden deneyin.
412004 InflightMessagesInLink Bağlantıda aktarım halinde olan iletiler var. Bağlantı durumunu denetleyin ve yeniden deneyin.

412002 DeviceMessageLockLost hatası

Buluttan cihaza ileti göndermeye çalışırken, isteğin hatasıyla 412002 DeviceMessageLockLostbaşarısız olduğunu görebilirsiniz.

Bu hata, bir cihaz kuyruktan buluttan cihaza bir ileti aldığında (örneğin, ReceiveAsync() kullanarak), IoT Hub'ın iletiyi bir dakikalık kilit zaman aşımı süresi boyunca kilitlemesinden dolayı oluşur. Cihaz, kilit zaman aşımı süresi dolduktan sonra iletiyi tamamlamaya çalışırsa IoT Hub bu özel durumu oluşturur.

IoT Hub bir dakikalık kilitleme zaman aşımı süresi içinde bildirimi almazsa, iletiyi yeniden Kuyruğa Alındı durumuna ayarlar. Cihaz iletiyi yeniden almayı deneyebilir. Hatanın gelecekte oluşmasını önlemek için, iletiyi aldıktan sonraki bir dakika içinde iletiyi tamamlamak için cihaz tarafı mantığı uygulayın. Bu bir dakikalık zaman aşımı değiştirilemez.

413xxx İstek varlığı çok büyük hatalar

IoT Hub'a yönelik isteklerinizin 413 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
413000 GenericRequestEntityTooLarge İstek varlığı çok büyük. Talep varlığının boyutunu küçültün ve tekrar deneyin.
413001 MesajÇokBüyük İleti fazla büyük. İletinin boyutunu küçültün ve yeniden deneyin.
413002 TooManyDevices Çok fazla cihaz kaydediliyor. Cihaz sayısını azaltın ve yeniden deneyin.
413003 Cihazda Çok Fazla Modül Cihazda çok fazla modül kaydediliyor. Modül sayısını azaltın ve yeniden deneyin.
413101 YapılandırmaSayısıSınırıAşıldı Yapılandırma sayısı sınırı aşıldı. Yapılandırma sayısını azaltın ve yeniden deneyin.
413201 DigitalTwinModelSayısıLimitAşıldı Dijital ikiz modeli sayısı sınırı aşıldı. Dijital ikiz modellerinin sayısını azaltın ve yeniden deneyin.
413202 InterfaceNameCompressionModelCountLimitExceeded Arabirim adı sıkıştırma modeli sayısı sınırı aşıldı. Arabirim adı sıkıştırma modellerinin sayısını azaltın ve yeniden deneyin.

415xxx Desteklenmeyen medya türü hataları

IoT Hub'a yönelik isteklerinizin 415 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
415000 GenericUnsupportedMediaType Medya türü desteklenmiyor. Medya türünü denetleyin ve yeniden deneyin.
415101 UyumsuzVeriTipi Veri türü uyumsuz. Veri türünü denetleyin ve yeniden deneyin.

429xxx Kısıtlama istisna hataları

IoT Hub'a yönelik isteklerinizin 429 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
429000 Çok Fazla İstek (GenericTooManyRequests) Çok fazla istek yapıldı. İstek sayısını azaltın ve yeniden deneyin.
429001 ThrottlingException Hız sınırlandırma istisnası oluştu. Daha fazla bilgi için Azaltma sınırları belgelerine bakın.
429002 ThrottleBacklogLimitExceeded Kısıtlama nedeniyle bekleyen isteklerin sayısı iş yükü sınırını aştı. İstek sayısını azaltın ve yeniden deneyin. Trafik şekillendirme yanıtı göndermeden önce trafik şekillendirmenin nasıl çalıştığı hakkında daha fazla bilgi için Trafik şekillendirme belgelerine bakın.
429003 ThrottlingBacklogTimeout Azaltma sonucu biriken istekler, bekleme kuyruğunda beklerken zaman aşımına uğradı. İstek sayısını azaltın ve yeniden deneyin.
429004 ThrottlingMaxActiveJobCountExceededed Etkin iş sayısı üst sınırı aşıldı. Etkin iş sayısını azaltın ve yeniden deneyin.
429005 DeviceThrottlingLimitExceeded Cihaz kısıtlama limiti aşıldı. Cihazdan gelen istek sayısını azaltın ve yeniden deneyin.

İstenen işlem için azaltma sınırlarını aştığınızda bu hatalar oluşur.

Azure İzleyici aracılığıyla yalnızca 429001 ThrottlingException hatayı, Azaltma Hataları Sayısı metriği altında izleyebilirsiniz. Şu anda diğer kısıtlama hataları bir ölçümle ilişkilendirilmemiştir ancak günlüklerde yakalanmaktadır.

Bu hataları çözmek için Telemetri iletisi gönderme denemeleri ölçümünüzü daha önce belirtilen sınırlarla karşılaştırarak sınırlama eşiğine ulaşıp ulaşmadığınızı kontrol edin. Ayrıca kısma hataları sayısı ölçümünü de kontrol edebilirsiniz. Bu ölçümler hakkında bilgi için bkz . Cihaz telemetrisi ölçümleri. IoT hub'ınızı izlemenize yardımcı olacak ölçümleri kullanma hakkında bilgi için bkz. Azure IoT Hub'ı izleme.

IoT Hub yalnızca sınır çok uzun bir süre ihlal edildikten sonra döndürülüyor 429001 ThrottlingException . Bu gecikme, IoT hub'ınız trafik yoğunluğu yaşarsa iletilerinizin bırakılmaması için uygulanır. Bu sırada, IoT Hub iletileri operasyon kısıtlama hızında işler ve bekleme kuyruğunda çok fazla trafik varsa bu hız yavaş olabilir. Daha fazla bilgi için IoT Hub kotaları ve kısıtlamanınTrafik şekillendirme bölümüne bakın.

Kota veya kısıtlama sınırlarına ulaşıyorsanız IoT hub'ı ölçeğini büyütmeyi deneyin.

499xxx İstemci kapalı istek hataları

IoT Hub'a yönelik isteklerinizin 499 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
499000 ClientClosedRequest İstemci isteği kapattı. Daha sonra tekrar deneyin.

500xxx İç sunucu hataları

IoT Hub'a yönelik isteklerinizin 500 ile başlayan veya bir sunucu hatasından bahseden bir hatayla başarısız olduğunu görebilirsiniz. Bazı olasılıklar şunlardır:

Hata Kodu Description
500001 ServerError Sunucu tarafı hatası oluştu.
GenericTimeout 500008 IoT Hub zaman aşımına uğramadan önce bağlantı isteğini tamamlayamadı.
ServiceUnavailable (hata kodu yok) IoT Hub bir iç hatayla karşılaştı.
InternalServerError (hata kodu yok) IoT Hub bir iç hatayla karşılaştı.

Hata yanıtının 500xxx birçok nedeni olabilir. Her durumda, sorun büyük olasılıkla geçicidir. IoT Hub ekibi SLA'yı korumak için çok çalışsa da, IoT Hub düğümlerinin küçük alt kümeleri zaman zaman geçici hatalarla karşılaşabilir. Cihazınız sorun yaşayan bir düğüme bağlanmaya çalıştığında bu hatayı alırsınız.

Cihazdan yeniden deneme yaparak 5000xx hataları hafifletin. Yeniden denemeleri otomatik olarak yönetmek için Azure IoT Hub SDK'larının en son sürümünü kullandığınızdan emin olun. Geçici hata işleme ve yeniden denemeler için en iyi yöntemler hakkında daha fazla bilgi için bkz. Geçici hata işleme.

Sorun devam ederse, IoT Hub'da bilinen bir sorun olup olmadığını görmek için Kaynak Durumu ve Azure Durumu'nu denetleyin. El ile yük devretme özelliğini de kullanabilirsiniz.

Bilinen bir sorun yoksa ve sorun devam ederse, daha fazla araştırma için desteğe başvurun .

IoT Hub'a yönelik isteklerinizin 5003 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
ModelRepoEndpointError 500301 Model deposu uç noktası geçersiz. Model deposu uç noktasını denetleyin ve yeniden deneyin.
500302 ResolutionError Bir çözüm hatası oluştu. Daha sonra tekrar deneyin.

IoT Hub'a yönelik isteklerinizin 5004 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
500401 Kimlik Bilgileri Alınamıyor Kimlik bilgileri getirilemiyor. Kimlik bilgilerini denetleyin ve yeniden deneyin.
500402 UnableToFetchTenantInfo - Kiracı bilgileri alınamadı Kiracı bilgileri getirilemiyor. Kiracı bilgilerini denetleyin ve yeniden deneyin.
500403 KimliğiPaylaşamıyor Kimlik paylaşılamıyor. Kimlik paylaşımı ayarlarını denetleyin ve yeniden deneyin.

IoT Hub'a yönelik isteklerinizin 5005 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
500501 UnableToExpandDiscoveryInfo Keşif bilgileri genişletilemiyor. Bulma bilgilerini denetleyin ve yeniden deneyin.
500502 UnableToExpandComponentInfo Bileşen bilgileri genişletilemiyor. Bileşen bilgilerini denetleyin ve yeniden deneyin.
500503 BileşenBilgisiSıkıştırılamıyor Bileşen bilgileri sıkıştırılamıyor. Bileşen bilgilerini denetleyin ve yeniden deneyin.
500504 UnableToCompressDiscoveryInfo (Keşif Bilgisi Sıkıştırılamadı) Keşif bilgileri sıkıştırılamıyor. Bulma bilgilerini denetleyin ve yeniden deneyin.
500505 OrphanDiscoveryDocument Bağımsız keşif dokümanı bulundu. Bulma belgesini denetleyin ve yeniden deneyin.

IoT Hub'a yönelik isteklerinizin 502 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
502000 GenericBadGateway Genel bir hatalı ağ geçidi hatası oluştu. Daha sonra tekrar deneyin.

IoT Hub'a yönelik isteklerinizin 503 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
503000 GenelHizmetKullanılamıyor Genel bir hizmet kullanılamıyor hatası meydana geldi. Daha sonra tekrar deneyin.
503001 ServiceUnavailable Hizmet kullanılamıyor. Daha sonra tekrar deneyin.
503004 IotHubActivationFailed IoT Hub etkinleştirmesi başarısız oldu. IoT Hub durumunu denetleyin ve yeniden deneyin.
503005 ServerBusy Sunucu meşgul. Daha sonra tekrar deneyin.
503006 IotHubRestoring IoT Hub yeniden kuruluyor. Daha sonra tekrar deneyin.
503008 AlıcıBağlantıAçılmaLimitli Alınan bağlantının açılması kısıtlandı. Daha sonra tekrar deneyin.

5031xx Cihaz modeli kullanılamıyor hataları

IoT Hub'a yönelik isteklerinizin 5031 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
503101 ConnectionUnavailable Bağlantı kullanılamıyor. Bağlantıyı denetleyin ve yeniden deneyin.
503102 Cihaz Mevcut Değil Cihaz kullanılamıyor. Cihaz durumunu denetleyin ve yeniden deneyin.

5032xx Konfigürasyon kullanılamıyor hataları

IoT Hub'a yönelik isteklerinizin 5032 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
503201 Yapılandırma Mevcut Değil Yapılandırma kullanılamıyor. Yapılandırmayı denetleyin ve yeniden deneyin.
503202 Grup Kullanılamıyor (GroupNotAvailable) Grup kullanılamıyor. Grubu denetleyin ve yeniden deneyin.

IoT Hub'a yönelik isteklerinizin 5033 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
503301 HostingServiceNotAvailable Barındırma hizmeti kullanılamıyor. Daha sonra tekrar deneyin.

IoT Hub'a yönelik isteklerinizin 504 ile başlayan bir hatayla başarısız olduğunu görebilirsiniz. Aşağıdaki tabloda hata kodları, açıklamaları ve olası çözümler listelenmektedir.

Hata Kodu Description Çözüm
504000 GenericGatewayTimeout Genel bir ağ geçidi zaman aşımı hatası oluştu. Daha sonra tekrar deneyin.
504101 GatewayTimeout Ağ geçidi zaman aşımına uğradı. Daha fazla bilgi için bkz. 504101 GatewayTimeout hatası .

504101 GatewayTimeout hatası

IoT Hub'dan bir cihaza doğrudan yöntem çağırmaya çalışırken, isteğin hatasıyla 504101 GatewayTimeoutbaşarısız olduğunu görebilirsiniz.

IoT Hub bir hatayla karşılaştığından ve zaman aşımına uğramadan önce doğrudan yöntemin tamamlanıp tamamlanmadığı doğrulanamadığından bu hata oluşur. Ya da Azure IoT C# SDK'sının (<1.19.0) önceki bir sürümünü kullanırken, bir hata nedeniyle cihaz ile IoT Hub arasındaki AMQP bağlantısı sessizce bırakılabilir.

Bu hatayı çözmek için yeniden deneyin veya Azure IOT C# SDK'sının en son sürümüne yükseltin.