Läsa meddelanden från enhet till moln från den inbyggda slutpunkten
Som standard dirigeras meddelanden till den inbyggda tjänstinriktade slutpunkten (meddelanden/händelser) som är kompatibel med Event Hubs. IoT Hub exponerar den inbyggda slutpunkten meddelanden/händelser för dina serverdelstjänster för att läsa meddelanden från enhet till moln som tas emot av hubben. Den här slutpunkten är Event Hubs-kompatibel, vilket gör att du kan använda någon av de mekanismer som Event Hubs-tjänsten stöder för att läsa meddelanden.
Om du använder meddelanderoutning och återställningsvägen är aktiverad går ett meddelande som inte matchar en fråga på någon väg till den inbyggda slutpunkten. Om du inaktiverar den här återställningsvägen tas ett meddelande som inte matchar någon fråga bort.
Den här slutpunkten exponeras för närvarande endast med hjälp av AMQP-protokollet på port 5671 och AMQP över WebSockets på port 443. En IoT-hubb exponerar följande egenskaper så att du kan styra de inbyggda Event Hub-kompatibla meddelandeslutpunktsmeddelandena /händelserna.
| Property | beskrivning |
|---|---|
| Antal partitioner | Ange den här egenskapen när du skapar den för att definiera antalet partitioner för händelseinmatning från enhet till moln. |
| Kvarhållningstid | Den här egenskapen anger hur länge i dagar meddelanden behålls av IoT Hub. Standardvärdet är en dag, men det kan ökas till sju dagar. |
IoT Hub tillåter datakvarhållning i den inbyggda slutpunkten i högst sju dagar. Du kan ange kvarhållningstiden när du skapar din IoT-hubb. Datakvarhållningstiden i IoT Hub beror på din IoT Hub-nivå och enhetstyp. När det gäller storlek kan den inbyggda slutpunkten behålla meddelanden med den maximala meddelandestorleken upp till minst 24 timmars kvot. En IoT-hubb för S1-enhet ger till exempel tillräckligt med lagringsutrymme för att behålla minst 400 000 meddelanden, med 4 kB per meddelande. Om dina enheter skickar mindre meddelanden kan de behållas längre (upp till sju dagar) beroende på hur mycket lagringsutrymme som förbrukas. Vi garanterar att kvarhålla data för den angivna kvarhållningstiden som ett minimum. När kvarhållningstiden har passerat upphör meddelandena att gälla och blir otillgängliga. Du kan ändra kvarhållningstiden, antingen programmatiskt med hjälp av REST-API:er för IoT Hub-resursprovidern eller med Azure-portalen.
Med IoT Hub kan du också hantera konsumentgrupper på den inbyggda slutpunkten. Du kan ha upp till 20 konsumentgrupper för varje IoT-hubb.
Anslut till den inbyggda slutpunkten
Vissa produktintegreringar och Event Hubs SDK:er är medvetna om IoT Hub och låter dig använda din IoT Hub-tjänst anslutningssträng för att ansluta till den inbyggda slutpunkten.
När du använder Event Hubs SDK:er eller produktintegreringar som inte känner till IoT Hub behöver du ett Event Hub-kompatibelt slutpunkts- och Event Hub-kompatibelt namn. Du kan hämta dessa värden från portalen på följande sätt:
Logga in på Azure-portalen och gå till din IoT-hubb.
Välj Inbyggda slutpunkter på resursmenyn under Hubbinställningar.
Arbetsfönstret Inbyggda slutpunkter innehåller tre avsnitt:
- Avsnittet Händelsehubbinformation innehåller följande värden: Partitioner, Event Hub-kompatibelt namn, Behåll för och Konsumentgrupper.
- Avsnittet Händelsehubbkompatibel slutpunkt innehåller följande värden: Princip för delad åtkomst och Händelsehubbkompatibel slutpunkt.
- Avsnittet Moln-till-enhet-meddelanden innehåller följande värden: Standard-TTL, Kvarhållningstid för feedback och Maximalt antal leveranser.
I arbetsfönstret innehåller det Event Hub-kompatibla slutpunktsfältet en fullständig Event Hubs-anslutningssträng som ser ut som i följande exempel:
Endpoint=sb://abcd1234namespace.servicebus.windows.net/; SharedAccessKeyName=iothubowner; SharedAccessKey=keykeykeykeykeykey=; EntityPath=iothub-ehub-abcd-1234-123456
Om SDK:et som du använder kräver andra värden skulle de vara:
| Name | Värde |
|---|---|
| Slutpunkt | sb://abcd1234namespace.servicebus.windows.net/ |
| Värdnamn | abcd1234namespace.servicebus.windows.net |
| Namnområde | abcd1234namespace |
Du kan sedan välja valfri princip för delad åtkomst från listrutan Princip för delad åtkomst, som du ser i föregående skärmbild. Den visar bara principer som har tjänsten Anslut behörighet att ansluta till den angivna händelsehubben.
SDK-exempel
De SDK:er som du kan använda för att ansluta till den inbyggda Event Hub-kompatibla slutpunkten som IoT Hub exponerar är:
De produktintegreringar du kan använda med den inbyggda Event Hub-kompatibla slutpunkten som IoT Hub exponerar är:
-
Mer information finns i Azure IoT Hub-bindningar för Azure Functions.
-
Mer information finns i Strömma data som indata till Stream Analytics.
-
Mer information finns i Lägga till en IoT Hub-händelsekälla i din Azure Time Series Insight-miljö.
-
Mer information finns i Apache Kafka-utvecklarguiden för Azure Event Hubs.
Nästa steg
Mer information om IoT Hub-slutpunkter finns i IoT Hub-slutpunkter.
Om du vill dirigera meddelanden från enhet till moln till anpassade slutpunkter läser du Använda meddelandevägar och anpassade slutpunkter för meddelanden från enhet till molnet.