Udostępnij za pomocą


Odczytywanie komunikatów przesyłanych z urządzeń do chmury z wbudowanego punktu końcowego

Domyślnie komunikaty są kierowane do wbudowanego punktu końcowego (komunikatów/zdarzeń) zgodnego z usługą Event Hubs. Usługa IoT Hub udostępnia wbudowany punkt końcowy dla komunikatów/zdarzeń dla usług zaplecza backendu w celu odczytania komunikatów z urządzenia do chmury odebranych przez IoT Hub. Ten punkt końcowy jest zgodny z usługą Event Hubs, co umożliwia korzystanie z dowolnych mechanizmów obsługiwanych przez usługę Event Hubs do odczytywania komunikatów.

Jeśli używasz routingu komunikatów, a trasa awaryjna jest włączona, komunikat, który nie pasuje do żadnego zapytania na trasach, przechodzi do wbudowanego punktu końcowego. Jeśli wyłączysz tę trasę rezerwową, komunikat, który nie pasuje do żadnego zapytania, zostanie odrzucony.

Ten punkt końcowy jest obecnie udostępniany tylko za pomocą protokołu AMQP na porcie 5671 oraz AMQP przez WebSocket na porcie 443. Centrum IoT udostępnia następujące właściwości, aby umożliwić sterowanie wbudowanym punktem końcowym komunikatów zgodnym z usługą Event Hubs messages/events.

Nieruchomość opis
Liczba partycji Ustaw tę właściwość podczas tworzenia, aby zdefiniować liczbę partycji pozyskiwania zdarzeń z urządzenia do chmury .
Czas przechowywania Ta właściwość określa, jak długo w dniach usługa IoT Hub zachowuje komunikaty. Wartość domyślna to jeden dzień, ale można ją zwiększyć do siedmiu dni.

Usługa IoT Hub umożliwia przechowywanie danych w wbudowanym punkcie końcowym przez maksymalnie siedem dni. Czas przechowywania można ustawić podczas tworzenia centrum IoT. Czas przechowywania danych w usłudze IoT Hub zależy od warstwy centrum IoT i typu jednostki. Jeśli chodzi o rozmiar, wbudowany punkt końcowy może przechowywać komunikaty o maksymalnym rozmiarze co najmniej przez 24 godziny w ramach przydziału. Na przykład jedno centrum IoT jednostki S1 zapewnia wystarczającą ilość miejsca do przechowywania co najmniej 400 000 komunikatów przy 4 KB na komunikat. Jeśli urządzenia wysyłają mniejsze komunikaty, mogą być przechowywane dłużej (do siedmiu dni) w zależności od ilości miejsca do magazynowania. Gwarantujemy, że dane będą przechowywane przez określony czas przechowywania co najmniej. Po upływie czasu przechowywania komunikaty wygasają i stają się niedostępne. Czas przechowywania można modyfikować programowo przy użyciu interfejsów API REST dostawcy zasobów Azure IoT Hub, lub za pomocą portalu Azure.

Usługa IoT Hub umożliwia również zarządzanie grupami odbiorców w wbudowanym punkcie końcowym. Dla każdego centrum IoT może być maksymalnie 20 grup odbiorców.

Połącz się z wbudowanym punktem końcowym

Niektóre integracje produktów i zestawy SDK usługi Event Hubs są świadome usługi IoT Hub i umożliwiają korzystanie z ciągu znaków połączenia usługi IoT Hub w celu nawiązania połączenia z wbudowanym punktem końcowym.

W przypadku korzystania z zestawów SDK usługi Event Hubs lub integracji produktów, które nie znają usługi IoT Hub, potrzebujesz punktu końcowego zgodnego z usługą Event Hubs i nazwy zgodnej z usługą Event Hubs. Te wartości można pobrać z portalu w następujący sposób:

  1. Zaloguj się do witryny Azure Portal i przejdź do centrum IoT Hub.

  2. Wybierz pozycję Wbudowane punkty końcowe z menu zasobów w obszarze Ustawienia centrum.

  3. Panel roboczy wbudowane punkty końcowe zawiera trzy sekcje:

    • Sekcja Szczegóły centrum zdarzeń zawiera następujące wartości: Partycje, Nazwa zgodna z centrum zdarzeń, Przechowywanie przez i Grupy Odbiorców.
    • Sekcja Punkt końcowy zgodny z centrum zdarzeń zawiera następujące wartości: Zasady dostępu współdzielonego i punkt końcowy zgodny z centrum zdarzeń.
    • Sekcja Komunikacja z chmury na urządzenie zawiera następujące wartości: Domyślny czas wygaśnięcia, Czas przechowywania opinii, i Maksymalna liczba dostarczeń.

    Przechwytywanie ekranu przedstawiające ustawienia urządzenia do chmury.

W okienku roboczym pole punktu końcowego zgodny z Event Hub zawiera kompletny łańcuch połączenia Event Hubs, które wyglądają jak w poniższym przykładzie:

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

Jeśli używany zestaw SDK wymaga innych wartości, będą one następujące:

Nazwa/nazwisko Wartość
Punkt końcowy sb://abcd1234namespace.servicebus.windows.net/
Hostname (Nazwa hosta) abcd1234namespace.servicebus.windows.net
Przestrzeń nazw abcd1234namespace

Następnie możesz wybrać dowolne zasady dostępu współdzielonego z listy rozwijanej Zasady dostępu współdzielonego, jak pokazano na poprzednim zrzucie ekranu. Wyświetlane są tylko zasady, które mają uprawnienia ServiceConnect do łączenia się z określonym centrum zdarzeń.

Przykłady dla zestawu SDK

SDK-i, których można użyć do połączenia z wbudowanym punktem końcowym zgodnym z Event Hubs, który udostępnia IoT Hub, to:

Język Zestaw do tworzenia oprogramowania Przykład
.SIEĆ https://www.nuget.org/packages/Azure.Messaging.EventHubs ReadD2cMessages .NET
Jawa https://mvnrepository.com/artifact/com.azure/azure-messaging-eventhubs read-d2c-messages Java - odczytuj wiadomości D2C Java
Node.js https://www.npmjs.com/package/@azure/event-hubs Odczytywanie wiadomości d2c w Node.js
Pyton https://pypi.org/project/azure-eventhub/ read-d2c-messages Python

Nawiązywanie połączenia z innymi usługami i produktami

Integracje produktów, których można używać z wbudowanym punktem końcowym zgodnym z usługą Event Hubs udostępnianym przez usługę IoT Hub, obejmują:

Następne kroki