IoT Hub uç noktaları
Not
Bu makalede bahsedilen buluttan cihaza mesajlaşma, cihaz ikizleri ve cihaz yönetimi gibi bazı özellikler yalnızca standart IoT Hub katmanında kullanılabilir. Temel ve standart/ücretsiz IoT Hub katmanları hakkında daha fazla bilgi için bkz. Çözümünüz için doğru IoT Hub katmanını seçme.
adları IoT Hub
Uç noktalarınızı barındıran IoT hub'ının ana bilgisayar adını ioT hub'ınızın Genel Bakış çalışma bölmesindeki Azure portal bulabilirsiniz. Varsayılan olarak, bir IoT hub'ının DNS adı aşağıdaki örneğe benzer:
{your iot hub name}.azure-devices.net
Yerleşik IoT Hub uç noktalarının listesi
Azure IoT Hub, işlevselliğini çeşitli aktörlere sunan çok kiracılı bir hizmettir. Aşağıdaki diyagramda IoT Hub kullanıma sunan çeşitli uç noktalar gösterilmektedir.
Aşağıdaki listede uç noktalar açıklanmaktadır:
Kaynak sağlayıcısı. IoT Hub kaynak sağlayıcısı bir Azure Resource Manager arabirimini kullanıma sunar. Bu arabirim, Azure abonelik sahiplerinin IoT hub'ları oluşturup silmesine ve IoT hub özelliklerini güncelleştirmesine olanak tanır. IoT Hub özellikleri, cihaz düzeyinde erişim denetiminin yanı sıra buluttan cihaza ve cihazdan buluta mesajlaşma için işlevsel seçeneklerin aksine merkez düzeyinde paylaşılan erişim ilkelerini yönetir. IoT Hub kaynak sağlayıcısı, cihaz kimliklerini dışarı aktarmanızı da sağlar.
Cihaz kimliği yönetimi. Her IoT hub'ı cihaz kimliklerini yönetmek (oluşturma, alma, güncelleştirme ve silme) için bir dizi HTTPS REST uç noktası sunar. Cihaz kimlikleri , cihaz kimlik doğrulaması ve erişim denetimi için kullanılır.
Cihaz ikizi yönetimi. Her IoT hub'ı , cihaz ikizlerini (etiketleri ve özellikleri güncelleştirme) sorgulamak ve güncelleştirmek için hizmete yönelik bir HTTPS REST uç noktası kümesini kullanıma sunar.
İş yönetimi. Her IoT hub'ı , işleri sorgulamak ve yönetmek için hizmete yönelik bir HTTPS REST uç noktası kümesi sunar.
Cihaz uç noktaları. Kimlik kayıt defterindeki her cihaz için IoT Hub bir uç nokta kümesi sunar. Not edilen durumlar dışında, bu uç noktalar MQTT v3.1.1, HTTPS 1.1 ve AMQP 1.0 protokolleri kullanılarak kullanıma sunulur. AMQP ve MQTT, 443 numaralı bağlantı noktası üzerindeki WebSockets üzerinden de kullanılabilir.
Cihazdan buluta iletiler gönderme. Bir cihaz, cihazdan buluta iletiler göndermek için bu uç noktayı kullanır.
Buluttan cihaza iletileri alın. Bir cihaz, hedeflenen buluttan cihaza iletileri almak için bu uç noktayı kullanır.
Dosya karşıya yüklemelerini başlatın. Bir cihaz, dosyayı karşıya yüklemek üzere IoT Hub azure depolama SAS URI'sini almak için bu uç noktayı kullanır.
Cihaz ikizi özelliklerini alma ve güncelleştirme. Bir cihaz, cihaz ikizlerinin özelliklerine erişmek için bu uç noktayı kullanır. HTTPS desteklenmez.
Doğrudan yöntem istekleri alın. Bir cihaz , doğrudan yöntem isteklerini dinlemek için bu uç noktayı kullanır. HTTPS desteklenmez.
Önemli
X.509 sertifika yetkilisi (CA) kimlik doğrulamasını kullanan cihazlar için aşağıdaki işlevler henüz genel kullanıma sunulmamaktadır ve önizleme modunun etkinleştirilmesi gerekir:
- HTTPS, WebSockets üzerinde MQTT ve WebSockets protokolleri üzerinden AMQP.
- Dosya yüklemeleri (tüm protokoller).
Bu özellikler genellikle X.509 parmak izi kimlik doğrulaması kullanan cihazlarda kullanılabilir. IoT Hub ile X.509 kimlik doğrulaması hakkında daha fazla bilgi edinmek için bkz. Desteklenen X.509 sertifikaları.
Hizmet uç noktaları. Her IoT hub'ı, çözüm arka ucunuzun cihazlarınızla iletişim kurması için bir uç nokta kümesi sunar. Bu uç noktalar yalnızca WebSockets üzerinden AMQP ve AMQP kullanılarak kullanıma sunulur. Doğrudan yöntem çağırma uç noktası HTTPS protokolü üzerinden kullanıma sunulur.
Cihazdan buluta iletileri alma. Bu uç nokta Azure Event Hubs ile uyumludur. Arka uç hizmeti, cihazlarınız tarafından gönderilen cihazdan buluta iletileri okumak için bu hizmeti kullanabilir. Bu yerleşik uç noktaya ek olarak IoT hub'ınızda özel uç noktalar oluşturabilirsiniz.
Buluttan cihaza iletiler gönderin ve teslim bildirimleri alın. Bu uç noktalar, çözüm arka ucunuzun güvenilir buluttan cihaza iletiler göndermesini ve ilgili teslim veya süre sonu onaylarını almasını sağlar.
Dosya bildirimlerini alın. Bu mesajlaşma uç noktası, cihazlarınız bir dosyayı başarıyla karşıya yüklediğinde bildirim almanızı sağlar.
Doğrudan yöntem çağırma. Bu uç nokta, bir arka uç hizmetinin bir cihazda doğrudan yöntem çağırmasına olanak tanır.
Azure IoT Hub SDK'ları makalesinde bu uç noktalara erişmenin çeşitli yolları açıklanmaktadır.
Tüm IoT Hub uç noktaları TLS protokolünü kullanır ve şifrelenmemiş/güvenli olmayan kanallarda hiçbir uç nokta gösterilmez.
Özel uç noktalar
İleti yönlendirme için uç nokta görevi görmesi için Azure aboneliklerinizdeki mevcut Azure hizmetlerini IoT hub'ınıza bağlayabilirsiniz. Bu uç noktalar hizmet uç noktaları olarak görev alır ve ileti yolları için havuz olarak kullanılır. Cihazlar doğrudan bu uç noktalara yazamaz. İleti yönlendirme hakkında daha fazla bilgi için bkz. Cihazdan buluta iletileri farklı uç noktalara göndermek için IoT Hub ileti yönlendirmeyi kullanma.
IoT Hub şu anda özel uç nokta olarak aşağıdaki Azure hizmetlerini desteklemektedir:
- Depolama kapsayıcıları
- Event Hubs
- Service Bus Kuyrukları
- Service Bus Konuları
- Cosmos DB (önizleme)
Ekleyebileceğiniz uç nokta sayısı sınırları için bkz. Kotalar ve azaltma.
Uç Nokta Durumu
Uç noktaların sistem durumunu almak için Uç Nokta Durumunu Alma REST API’sini kullanabilirsiniz. Uç nokta bu durumlardan birinde olduğunda gecikme süresinin daha yüksek olmasını beklediğimiz için uç nokta sistem durumu ölü veya iyi durumda olmadığında hataları belirlemek ve hatalarını ayıklamak için yönlendirme iletisi gecikme süresiyle ilgili IoT Hub yönlendirme ölçümlerini kullanmanızı öneririz. IoT Hub ölçümleri kullanma hakkında daha fazla bilgi edinmek için bkz. İzleme IoT Hub.
| Sistem Durumu | Description |
|---|---|
| Sağlıklı | Uç nokta iletileri beklendiği gibi kabul ediyor. |
| Sağlıksız | Uç nokta iletileri kabul etmediğinden IoT Hub bu uç noktaya ileti göndermeyi yeniden dener. |
| Bilinmeyen | IoT Hub bu uç noktaya ileti teslim etmeye çalışmadı. |
| Bozulmuş | Uç nokta beklenenden daha yavaş iletileri kabul ediyor veya iyi durumda değil durumundan kurtarılıyor. |
| Ölü | IoT Hub artık bu uç noktaya ileti teslim etmemeye devam ediyor. Bu uç noktaya ileti göndermek için yeniden denemeler başarısız oldu. |
Alan ağ geçitleri
IoT çözümünde, cihazlarınızla IoT Hub uç noktalarınız arasında bir alan ağ geçidi bulunur. Genellikle cihazlarınıza yakın bir yerde bulunur. Cihazlarınız, cihazlar tarafından desteklenen bir protokol kullanarak doğrudan alan ağ geçidiyle iletişim kurar. Alan ağ geçidi, IoT Hub tarafından desteklenen bir protokol kullanarak bir IoT Hub uç noktasına bağlanır. Alan ağ geçidi, özel bir donanım cihazı veya özel ağ geçidi yazılımı çalıştıran düşük güçlü bir bilgisayar olabilir.
Azure IoT Edge kullanarak bir alan ağ geçidi uygulayabilirsiniz. IoT Edge, birden çok cihazdan aynı IoT Hub bağlantısına iletişimi çoğullama gibi işlevler sunar.
Sonraki adımlar
Bu IoT Hub geliştirici kılavuzundaki diğer başvuru konuları şunlardır: