Apparaat-naar-cloud-berichten lezen van het geïntegreerde eindpunt
Berichten worden standaard doorgestuurd naar het ingebouwde servicegerichte eindpunt (berichten/gebeurtenissen) dat compatibel is met Event Hubs. IoT Hub toont de ingebouwde berichten/gebeurtenissen voor uw back-endservices om de apparaat-naar-cloud-berichten te lezen die door uw hub worden ontvangen. Dit eindpunt is compatibel met Event Hubs, waarmee u een van de mechanismen kunt gebruiken die de Event Hubs-service ondersteunt voor het lezen van berichten.
Als u berichtroutering gebruikt en de terugvalroute is ingeschakeld, gaat een bericht dat niet overeenkomt met een query op een route naar het ingebouwde eindpunt. Als u deze terugvalroute uitschakelt, wordt een bericht dat niet overeenkomt met een query verwijderd.
Dit eindpunt wordt momenteel alleen weergegeven met behulp van het AMQP-protocol op poort 5671 en AMQP via WebSockets op poort 443. Een IoT-hub bevat de volgende eigenschappen om u in staat te stellen om de ingebouwde berichten/gebeurtenissen voor het berichteneindpunt te beheren die compatibel zijn met Event Hub.
| Eigenschappen | Beschrijving |
|---|---|
| Aantal partities | Stel deze eigenschap in bij het maken om het aantal partities voor opname van apparaat-naar-cloudgebeurtenissen te definiëren. |
| Bewaartijd | Met deze eigenschap wordt aangegeven hoe lang berichten in dagen worden bewaard door IoT Hub. De standaardwaarde is één dag, maar kan worden verhoogd tot zeven dagen. |
Met IoT Hub kan gegevens gedurende maximaal zeven dagen in het ingebouwde eindpunt worden bewaard. U kunt de bewaartijd instellen tijdens het maken van uw IoT-hub. De bewaartijd van gegevens in IoT Hub is afhankelijk van uw IoT-hublaag en -eenheidstype. Wat de grootte betreft, kan het ingebouwde eindpunt berichten van de maximale berichtgrootte tot ten minste 24 uur aan quotum behouden. Een IoT-hub van één S1-eenheid biedt bijvoorbeeld voldoende opslagruimte om ten minste 400.000 berichten te bewaren, met 4 kB per bericht. Als uw apparaten kleinere berichten verzenden, kunnen ze langer (maximaal zeven dagen) worden bewaard, afhankelijk van de hoeveelheid opslagruimte die wordt verbruikt. We garanderen dat de gegevens voor de opgegeven bewaartijd minimaal worden bewaard. Nadat de bewaartijd is verstreken, verlopen berichten en worden ze ontoegankelijk. U kunt de bewaartijd programmatisch wijzigen met behulp van de REST API's van de IoT Hub-resourceprovider of met Azure Portal.
Met IoT Hub kunt u ook consumentengroepen beheren op het ingebouwde eindpunt. U kunt maximaal 20 consumentengroepen hebben voor elke IoT-hub.
Verbinding maken naar het ingebouwde eindpunt
Sommige productintegraties en Event Hubs SDK's zijn op de hoogte van IoT Hub en u kunt uw IoT Hub-service verbindingsreeks gebruiken om verbinding te maken met het ingebouwde eindpunt.
Wanneer u Event Hubs-SDK's of productintegraties gebruikt die zich niet bewust zijn van IoT Hub, hebt u een event hub-compatibel eindpunt en event hub-compatibele naam nodig. U kunt deze waarden als volgt ophalen uit de portal:
Meld u aan bij de Azure-portal en ga naar uw IoT Hub.
Selecteer Ingebouwde eindpunten in het resourcemenu onder Hub-instellingen.
Het werkvenster Ingebouwde eindpunten bevat drie secties :
- De sectie Details van Event Hub bevat de volgende waarden: Partities, naam die compatibel is met Event Hub, Behouden voor en Consumentengroepen.
- De sectie Met Event Hub compatibel eindpunt bevat de volgende waarden: Beleid voor gedeelde toegang en event hub-compatibele eindpunten.
- De sectie Cloud-naar-apparaatberichten bevat de volgende waarden: Standaard-TTL, retentietijd voor feedback en maximum aantal bezorgingen.
In het werkvenster bevat het veld Event Hub-compatibele eindpunten een volledige Event Hubs-verbindingsreeks die eruitziet als in het volgende voorbeeld:
Endpoint=sb://abcd1234namespace.servicebus.windows.net/; SharedAccessKeyName=iothubowner; SharedAccessKey=keykeykeykeykey=; EntityPath=iothub-ehub-abcd-1234-123456
Als voor de SDK die u gebruikt andere waarden zijn vereist, zijn dit:
| Naam | Weergegeven als |
|---|---|
| Eindpunt | sb://abcd1234namespace.servicebus.windows.net/ |
| Hostnaam | abcd1234namespace.servicebus.windows.net |
| Naamruimte | abcd1234namespace |
U kunt vervolgens elk beleid voor gedeelde toegang kiezen in de vervolgkeuzelijst Gedeeld toegangsbeleid , zoals wordt weergegeven in de vorige schermafbeelding. Er worden alleen beleidsregels weergegeven met de service Verbinding maken machtigingen om verbinding te maken met de opgegeven Event Hub.
SDK-voorbeelden
De SDK's die u kunt gebruiken om verbinding te maken met het ingebouwde Event Hub-compatibele eindpunt dat ioT Hub beschikbaar maakt, zijn onder andere:
De productintegraties die u kunt gebruiken met het ingebouwde Event Hub-compatibele eindpunt dat ioT Hub beschikbaar maakt, zijn onder andere:
-
Zie Azure IoT Hub-bindingen voor Azure Functions voor meer informatie.
-
Zie Stream-gegevens als invoer in Stream Analytics voor meer informatie.
-
Zie Een IoT Hub-gebeurtenisbron toevoegen aan uw Azure Time Series Insight-omgeving voor meer informatie.
-
Zie de Ontwikkelaarshandleiding voor Apache Kafka voor Azure Event Hubs voor meer informatie.
Volgende stappen
Zie IoT Hub-eindpunten voor meer informatie over IoT Hub-eindpunten.
Zie Berichtroutes en aangepaste eindpunten gebruiken voor apparaat-naar-cloud-berichten als u uw apparaat-naar-cloud-berichten wilt routeren naar aangepaste eindpunten.