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 uwidacznia wbudowane komunikaty/zdarzenia dla usług zaplecza w celu odczytania komunikatów z urządzenia do chmury odebranych przez centrum. 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 rezerwowa jest włączona, komunikat, który nie pasuje do zapytania na żadnej trasie, przechodzi do wbudowanego punktu końcowego. Jeśli wyłączysz tę trasę rezerwową, zostanie porzucony komunikat, który nie pasuje do żadnego zapytania.
Ten punkt końcowy jest obecnie uwidaczniony tylko przy użyciu protokołu AMQP na porcie 5671 i protokołu AMQP za pośrednictwem obiektów WebSocket na porcie 443. Centrum IoT udostępnia następujące właściwości, aby umożliwić sterowanie wbudowanymi komunikatami/zdarzeniami zgodnymi z centrum zdarzeń.
| Właściwości | 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 komunikaty są przechowywane przez usługę IoT Hub. 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 komunikatu do co najmniej 24 godzin 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 usługi IoT Hub lub witryny Azure Portal.
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łączenie do wbudowanego punktu końcowego
Niektóre integracje produktów i zestawy SDK usługi Event Hubs są świadome usługi IoT Hub i umożliwiają korzystanie z usługi IoT Hub parametry połączenia 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 zgodnego z centrum zdarzeń punktu końcowego i nazwy zgodnej z centrum zdarzeń. Te wartości można pobrać z portalu w następujący sposób:
Zaloguj się do witryny Azure Portal i przejdź do centrum IoT Hub.
Wybierz pozycję Wbudowane punkty końcowe z menu zasobów w obszarze Ustawienia centrum.
Okienko robocze Wbudowane punkty końcowe zawiera trzy sekcje:
- Sekcja Szczegóły centrum zdarzeń zawiera następujące wartości: Partycje, nazwa zgodna z centrum zdarzeń, zachowanie dla 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 Obsługa komunikatów w chmurze na urządzenie zawiera następujące wartości: Domyślny czas wygaśnięcia, czas przechowywania opinii i Maksymalna liczba dostarczania.
W okienku roboczym pole punkt końcowy zgodny z centrum zdarzeń zawiera kompletne parametry połączenia usługi 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. Pokazuje on tylko zasady, które mają uprawnienia usługi Połączenie do łączenia się z określonym centrum zdarzeń.
Przykłady dla zestawu SDK
Zestawy SDK, których można użyć do nawiązania połączenia z wbudowanym punktem końcowym zgodnym z centrum zdarzeń, który uwidacznia usługa IoT Hub:
Integracje produktów, których można używać z wbudowanym punktem końcowym zgodnym z centrum zdarzeń, który uwidacznia usługa IoT Hub:
-
Aby uzyskać więcej informacji, zobacz Powiązania usługi Azure IoT Hub dla usługi Azure Functions.
-
Aby uzyskać więcej informacji, zobacz Stream data as input into Stream Analytics (Przesyłanie strumieniowe danych jako dane wejściowe do usługi Stream Analytics).
-
Aby uzyskać więcej informacji, zobacz Dodawanie źródła zdarzeń centrum IoT hub do środowiska usługi Azure Time Series Insight.
-
Aby uzyskać więcej informacji, zobacz Przewodnik dla deweloperów platformy Apache Kafka dotyczący usługi Azure Event Hubs.
Następne kroki
Aby uzyskać więcej informacji na temat punktów końcowych usługi IoT Hub, zobacz Punkty końcowe usługi IoT Hub.
Jeśli chcesz kierować komunikaty z urządzenia do chmury do niestandardowych punktów końcowych, zobacz Używanie tras komunikatów i niestandardowych punktów końcowych dla komunikatów z urządzenia do chmury.