Cihazdan buluta iletilerini yerleşik uç noktadan okuma

varsayılan olarak, iletiler Event Hubs ile uyumlu yerleşik hizmete yönelik uç noktaya (iletiler/olaylar) yönlendirilir. IoT Hub, arka uç hizmetlerinizin hub'ınız tarafından alınan cihazdan buluta iletileri okuması için yerleşik iletileri/olayları kullanıma sunar. Bu uç nokta, Event Hubs hizmetinin iletileri okumak için desteklediği mekanizmalardan herhangi birini kullanmanızı sağlayan Event Hubs uyumludur.

İleti yönlendirme kullanıyorsanız ve geri dönüş yolu etkinse, herhangi bir yoldaki sorguyla eşleşmeyen bir ileti yerleşik uç noktaya gider. Bu geri dönüş yolunu devre dışı bırakırsanız, hiçbir sorguyla eşleşmeyen bir ileti bırakılır.

Bu uç nokta şu anda yalnızca 5671 numaralı bağlantı noktasında AMQP protokolü ve 443 numaralı bağlantı noktası üzerinde WebSockets üzerinden AMQP kullanılarak kullanıma sunulur. IoT hub'ı, yerleşik Event Hub uyumlu mesajlaşma uç noktası iletilerini/olaylarını denetlemenizi sağlamak için aşağıdaki özellikleri kullanıma sunar.

Özellik Açıklama
Bölüm sayısı Cihazdan buluta olay alımı için bölüm sayısını tanımlamak için oluşturma sırasında bu özelliği ayarlayın.
Bekletme süresi Bu özellik, iletilerin IoT Hub tarafından ne kadar süreyle tutulanı belirtir. Varsayılan değer bir gündür, ancak yedi güne artırılabilir.

IoT Hub, yerleşik uç noktada en fazla yedi gün boyunca veri saklamaya olanak tanır. IoT hub'ınızı oluştururken bekletme süresini ayarlayabilirsiniz. IoT Hub'da veri saklama süresi, IoT hub katmanınıza ve birim türüne bağlıdır. Boyut açısından, yerleşik uç nokta en az 24 saatlik kotaya kadar ileti boyutu üst sınırına sahip iletileri koruyabilir. Örneğin, bir S1 birim IoT hub'ı en az 400.000 iletiyi, ileti başına 4 KB'de tutmak için yeterli depolama alanı sağlar. Cihazlarınız daha küçük iletiler gönderiyorsa, ne kadar depolama alanı tüketilmesine bağlı olarak daha uzun süre (yedi güne kadar) tutulabilir. Belirtilen saklama süresi için verileri en az olarak saklamayı garanti ediyoruz. Bekletme süresi geçtikten sonra iletilerin süresi dolar ve erişilemez duruma gelir. Bekletme süresini IoT Hub kaynak sağlayıcısı REST API'lerini kullanarak veya Azure portalıyla program aracılığıyla değiştirebilirsiniz.

IoT Hub, yerleşik uç noktadaki tüketici gruplarını yönetmenizi de sağlar. Her IoT hub'ı için en fazla 20 tüketici grubunuz olabilir.

Yerleşik uç noktaya Bağlan

Bazı ürün tümleştirmeleri ve Event Hubs SDK'ları IoT Hub'ı algılar ve yerleşik uç noktaya bağlanmak için IoT hub hizmeti bağlantı dizesi kullanmanıza olanak sağlar.

Event Hubs SDK'larını veya IoT Hub'ın farkında olmayan ürün tümleştirmelerini kullandığınızda, Event Hub ile uyumlu bir uç nokta ve Event Hub uyumlu bir ad gerekir. Bu değerleri portaldan aşağıdaki gibi alabilirsiniz:

  1. Azure portalında oturum açın ve IoT hub'ınıza gidin.

  2. Kaynak menüsünden Hub ayarları'nın altındaki Yerleşik uç noktalar'ı seçin.

  3. Yerleşik uç noktalar çalışma bölmesi üç bölüm içerir:

    • Olay Hub'ı Ayrıntıları bölümü şu değerleri içerir: Bölümler, Olay Hub'ı ile uyumlu ad, Saklama için ve Tüketici Grupları.
    • Olay Hub'ı uyumlu uç nokta bölümü şu değerleri içerir: Paylaşılan erişim ilkesi ve Event Hub ile uyumlu uç nokta.
    • Buluttan cihaza mesajlaşma bölümü şu değerleri içerir: Varsayılan TTL, Geri bildirim saklama süresi ve Maksimum teslim sayısı.

    Screen capture showing device-to-cloud settings.

Çalışma bölmesinde Event Hub uyumlu uç nokta alanı, aşağıdaki örneğe benzeyen eksiksiz bir Event Hubs bağlantı dizesi içerir:

Endpoint=sb://abcd1234namespace.servicebus.windows.net/; SharedAccessKeyName=iothubowner; SharedAccessKey=keykeykeykeykey=; EntityPath=iothub-ehub-abcd-1234-123456

Kullandığınız SDK başka değerler gerektiriyorsa şunlar olabilir:

Veri Akışı Adı Değer
Uç nokta sb://abcd1234namespace.servicebus.windows.net/
Konak adı abcd1234namespace.servicebus.windows.net
Ad Alanı abcd1234namespace

Daha sonra, önceki ekran görüntüsünde gösterildiği gibi Paylaşılan erişim ilkesi açılan listesinden herhangi bir paylaşılan erişim ilkesi seçebilirsiniz. Yalnızca belirtilen olay hub'ına bağlanmak için Hizmet Bağlan izinlerine sahip ilkeleri gösterir.

SDK örnekleri

IoT Hub'ın kullanıma açık olduğu yerleşik Event Hub uyumlu uç noktaya bağlanmak için kullanabileceğiniz SDK'lar şunlardır:

Dil SDK Örnek
.NET https://www.nuget.org/packages/Azure.Messaging.EventHubs ReadD2cMessages .NET
Java https://mvnrepository.com/artifact/com.azure/azure-messaging-eventhubs
Node.js https://www.npmjs.com/package/@azure/event-hubs read-d2c-messages Node.js
Python https://pypi.org/project/azure-eventhub/ read-dec-messages Python

IoT Hub'ın kullanıma sunulan yerleşik Event Hub uyumlu uç noktasıyla kullanabileceğiniz ürün tümleştirmeleri şunlardır:

Sonraki adımlar

  • IoT Hub uç noktaları hakkında daha fazla bilgi için bkz . IoT Hub uç noktaları.

  • Cihazınızdan buluta iletilerinizi özel uç noktalara yönlendirmek istiyorsanız bkz . Cihazdan buluta iletiler için ileti yollarını ve özel uç noktaları kullanma.