Az eszközről a felhőbe irányuló üzenetek beolvasása a beépített végpontról

Alapértelmezés szerint az üzenetek az Event Hubs szolgáltatással kompatibilis beépített szolgáltatásoldali végpontra (üzenetekre/eseményekre) lesznek irányítva. Az IoT Hub elérhetővé teszi a háttérszolgáltatások beépített üzeneteit/eseményeit , hogy beolvassa a központ által fogadott eszközről a felhőbe irányuló üzeneteket. Ez a végpont Event Hubs-kompatibilis, így az Event Hubs szolgáltatás által az üzenetek olvasásához támogatott mechanizmusok bármelyikét használhatja.

Ha üzenet-útválasztást használ, és a tartalék útvonal engedélyezve van, egy olyan üzenet kerül a beépített végpontra, amely egyetlen útvonal lekérdezésével sem egyezik meg. Ha letiltja ezt a tartalék útvonalat, a rendszer elvet egy olyan üzenetet, amely nem egyezik a lekérdezéssel.

Ez a végpont jelenleg csak az AMQP protokoll használatával érhető el az 5671-es porton, az AMQP pedig a 443-as porton lévő WebSocketeken keresztül. Az IoT Hub az alábbi tulajdonságokat teszi elérhetővé, amelyekkel szabályozhatja a beépített Event Hub-kompatibilis üzenetkezelési végpontüzeneteket /eseményeket.

Tulajdonság Leírás
Partíciók száma Állítsa be ezt a tulajdonságot a létrehozáskor, hogy meghatározza az eszközről a felhőbe irányuló eseménybetöltés partícióinak számát.
Megőrzési idő Ez a tulajdonság azt határozza meg, hogy az IoT Hub mennyi ideig őrizze meg az üzeneteket napokban. Az alapértelmezett érték egy nap, de hét napra növelhető.

Az IoT Hub legfeljebb hét napig teszi lehetővé a beépített végpont adatmegőrzését. Az IoT Hub létrehozása során beállíthatja a megőrzési időt. Az IoT Hub adatmegőrzési ideje az IoT Hub szintjétől és egységtípusától függ. A méret szempontjából a beépített végpont legfeljebb 24 órányi kvótáig képes megőrizni a maximális üzenetméretű üzeneteket. Például egy S1 egység IoT Hub elegendő tárterületet biztosít legalább 400 000 üzenet tárolásához, üzenetenként 4 KB-os értéken. Ha az eszközök kisebb üzeneteket küldenek, előfordulhat, hogy hosszabb ideig (akár hét napig) is megmaradnak attól függően, hogy mennyi tárhelyet használnak fel. Garantáljuk, hogy az adatok a megadott megőrzési időre minimálisan megmaradnak. A megőrzési idő letelte után az üzenetek lejárnak, és elérhetetlenné válnak. A megőrzési időt programozott módon módosíthatja az IoT Hub erőforrás-szolgáltató REST API-ival vagy az Azure Portallal.

Az IoT Hub lehetővé teszi a fogyasztói csoportok kezelését is a beépített végponton. Minden IoT Hubhoz legfeljebb 20 fogyasztói csoport tartozhat.

Csatlakozás a beépített végpontra

Egyes termékintegrációk és Event Hubs SDK-k ismerik az IoT Hubot, és lehetővé teszik az IoT Hub szolgáltatás kapcsolati sztring használatát a beépített végponthoz való csatlakozáshoz.

Ha olyan Event Hubs SDK-kat vagy termékintegrációkat használ, amelyek nem ismerik az IoT Hubot, eseményközpont-kompatibilis végpontra és Event Hub-kompatibilis névre van szüksége. Ezeket az értékeket az alábbiak szerint kérdezheti le a portálról:

  1. Jelentkezzen be az Azure Portalra , és lépjen az IoT Hubra.

  2. Válassza ki a beépített végpontokat az erőforrás menüjében, a Központi beállítások területen.

  3. A beépített végpontok munkaablaka három szakaszt tartalmaz:

    • Az Eseményközpont részletei szakasz a következő értékeket tartalmazza: Partíciók, Event Hub-kompatibilis név, Megtartás és Fogyasztói csoportok.
    • Az Event Hub-kompatibilis végpontszakasz a következő értékeket tartalmazza: Megosztott hozzáférési szabályzat és Event Hub-kompatibilis végpont.
    • A Felhő–eszköz üzenetkezelés szakasz a következő értékeket tartalmazza: alapértelmezett TTL, visszajelzési megőrzési idő és maximális kézbesítési szám.

    Screen capture showing device-to-cloud settings.

A munkaablakban az Event Hub-kompatibilis végpontmező egy teljes Event Hubs-kapcsolati sztring tartalmaz, amely az alábbi példához hasonlóan néz ki:

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

Ha a használt SDK-nak más értékekre van szüksége, akkor a következő lenne:

Név szerint Érték
Végpont sb://abcd1234namespace.servicebus.windows.net/
Hostname (Gazdanév) abcd1234namespace.servicebus.windows.net
Névtér abcd1234namespace

Ezután a Megosztott hozzáférési szabályzat legördülő menüből választhatja ki a megosztott hozzáférési szabályzatokat , ahogy az előző képernyőképen is látható. Csak azokat a szabályzatokat jeleníti meg, amelyek rendelkeznek a Szolgáltatás Csatlakozás engedéllyel a megadott eseményközponthoz való csatlakozáshoz.

SDK-minták

Az IoT Hub által elérhetővé tesz beépített Event Hub-kompatibilis végponthoz való csatlakozáshoz használható SDK-k a következők:

Nyelv SDK Példa
.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

Az IoT Hub által elérhető beépített Event Hub-kompatibilis végponttal használható termékintegrációk a következők:

Következő lépések

  • Az IoT Hub-végpontokkal kapcsolatos további információkért lásd az IoT Hub-végpontokat.

  • Ha az eszközről a felhőbe irányuló üzeneteket egyéni végpontokra szeretné irányítani, olvassa el az Üzenetútvonalak és egyéni végpontok használata eszközről a felhőbe üzenetre című témakört.