Aracılığıyla paylaş

Cihazdan buluta iletilerini yerleşik uç noktadan okuma

  • Makale

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 Hubs 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, IoT Hub'ın iletileri ne kadar süreyle saklayalı olduğunu 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. Saklama süresinden 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ğlanma

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'dan habersiz ürün tümleştirmelerini kullandığınızda, Event Hubs uyumlu bir uç nokta ve Event Hubs 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ı.

    Cihazdan buluta ayarları gösteren ekran görüntüsü.

Ç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 ServiceConnect izinlerine sahip ilkeleri gösterir.

SDK örnekleri

IoT Hub'ın kullanıma sunun yerleşik Event Hubs uyumlu uç noktasına 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 read-d2c-messages Java
Node.js https://www.npmjs.com/package/@azure/event-hubs read-d2c-messages Node.js
Python https://pypi.org/project/azure-eventhub/ read-d2c-messages Python

Diğer hizmet ve ürünlere bağlanma

IoT Hub'ın kullanıma sunulan yerleşik Event Hubs 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.