Čtení zpráv ze zařízení do cloudu z integrovaného koncového bodu

Ve výchozím nastavení se zprávy směrují do integrovaného koncového bodu (zpráv/událostí), který je kompatibilní se službou Event Hubs. IoT Hub zveřejňuje předdefinovaný koncový bod zpráv a událostí pro vaše back-endové služby ke čtení zpráv ze zařízení do cloudu přijatých centrem. Tento koncový bod je kompatibilní se službou Event Hubs, která umožňuje používat některý z mechanismů, které služba Event Hubs podporuje ke čtení zpráv.

Pokud používáte směrování zpráv a záložní trasa je povolená, zpráva, která neodpovídá dotazu na žádné trase, přejde do integrovaného koncového bodu. Pokud tuto náhradní trasu zakážete, zahodí se zpráva, která neodpovídá žádnému dotazu.

Tento koncový bod je aktuálně přístupný pouze pomocí protokolu AMQP na portu 5671 a AMQP přes WebSocket na portu 443. IoT Hub zveřejňuje následující vlastnosti, které vám umožní řídit zprávy a události koncového bodu kompatibilní s integrovanou službou Event Hub.

Vlastnost Popis
Počet oddílů Nastavte tuto vlastnost při vytváření, abyste definovali počet oddílů pro příjem událostí typu zařízení-cloud.
Doba uchování Tato vlastnost určuje, jak dlouho se zprávy ve dnech uchovávají službou IoT Hub. Výchozí hodnota je jeden den, ale může být zvýšena na sedm dní.

IoT Hub umožňuje uchovávání dat v integrovaném koncovém bodu po dobu maximálně sedmi dnů. Dobu uchovávání můžete nastavit během vytváření centra IoT. Doba uchovávání dat ve službě IoT Hub závisí na vaší úrovni a typu jednotky služby IoT Hub. Z hlediska velikosti může integrovaný koncový bod uchovávat zprávy o maximální velikosti zprávy až do 24 hodin kvóty. Například jedno centrum IoT jednotky S1 poskytuje dostatek úložiště pro uchovávání alespoň 400 000 zpráv v 4 kB na zprávu. Pokud vaše zařízení odesílají menší zprávy, můžou se uchovávat déle (až sedm dní) v závislosti na spotřebě úložiště. Zaručujeme, že se data zadanou dobu uchovávání uchovávají minimálně. Po uplynutí doby uchovávání vyprší platnost zpráv a stane se nepřístupným. Dobu uchovávání můžete upravit prostřednictvím kódu programu pomocí rozhraní REST API poskytovatele prostředků služby IoT Hub nebo webu Azure Portal.

IoT Hub také umožňuje spravovat skupiny příjemců v integrovaném koncovém bodu. Pro každé centrum IoT můžete mít až 20 skupin příjemců.

Připojení k integrovanému koncovému bodu

Některé integrace produktů a sady SDK služby Event Hubs o službě IoT Hub vědí a umožňují používat službu IoT Hub připojovací řetězec pro připojení k integrovanému koncovému bodu.

Pokud používáte sady SDK služby Event Hubs nebo integrace produktů, které o službě IoT Hub neví, potřebujete koncový bod kompatibilní s centrem událostí a název kompatibilní s centrem událostí. Tyto hodnoty můžete načíst z portálu následujícím způsobem:

  1. Přihlaste se k webu Azure Portal a přejděte do centra IoT.

  2. V nabídce prostředků vyberte předdefinované koncové body v části Nastavení centra.

  3. Pracovní podokno předdefinovaných koncových bodů obsahuje tři části:

    • Část Podrobnosti centra událostí obsahuje následující hodnoty: Oddíly, název kompatibilní s centrem událostí, zachování skupin a skupiny příjemců.
    • Část koncového bodu kompatibilní s centrem událostí obsahuje následující hodnoty: zásady sdíleného přístupu a koncový bod kompatibilní s centrem událostí.
    • Část Zasílání zpráv typu Cloud-zařízení obsahuje následující hodnoty: Výchozí hodnota TTL, doba uchovávání zpětné vazby a maximální počet doručení.

    Screen capture showing device-to-cloud settings.

V pracovním podokně obsahuje pole koncového bodu kompatibilního s centrem událostí kompletní připojovací řetězec služby Event Hubs, která vypadá jako v následujícím příkladu:

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

Pokud sada SDK, kterou používáte, vyžaduje další hodnoty, pak by byla:

Jméno Hodnota
Koncový bod sb://abcd1234namespace.servicebus.windows.net/
Název hostitele abcd1234namespace.servicebus.windows.net
Obor názvů abcd1234namespace

Pak můžete zvolit všechny zásady sdíleného přístupu z rozevíracího seznamu Zásady sdíleného přístupu, jak je znázorněno na předchozím snímku obrazovky. Zobrazuje jenom zásady, které mají oprávnění ke službě Připojení pro připojení k zadanému centru událostí.

Ukázky SDK

Sady SDK, které můžete použít k připojení k integrovanému koncovému bodu kompatibilnímu s centrem událostí, který Služba IoT Hub zveřejňuje, zahrnují:

Jazyk Sada SDK Příklad
.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

Integrace produktů, které můžete použít s integrovaným koncovým bodem kompatibilním s centrem událostí, který Služba IoT Hub zveřejňuje, zahrnují:

Další kroky