Naslag - IoT Hub eindpunten

Notitie

Sommige van de functies die in dit artikel worden genoemd, zoals cloud-naar-apparaat-berichten, apparaatdubbels en apparaatbeheer, zijn alleen beschikbaar in de standaardlaag van IoT Hub. Raadpleeg How to choose the right IoT Hub tier (De juiste IoT Hub-prijscategorie kiezen) voor meer informatie over de Basic- en Standard-prijscategorieën van IoT Hub.

IoT Hub namen

U vindt de hostnaam van de IoT-hub die uw eindpunten host in de portal op de overzichtspagina van uw hub. De DNS-naam van een IoT-hub ziet er standaard als: {your iot hub name}.azure-devices.net .

Lijst met ingebouwde IoT Hub eindpunten

Azure IoT Hub is een service met meerdere tenants die de functionaliteit beschikbaar maakt voor verschillende actoren. In het volgende diagram ziet u de verschillende eindpunten die IoT Hub worden weergegeven.

IoT Hub-eindpunten

In de volgende lijst worden de eindpunten beschreven:

  • Resourceprovider. De IoT Hub resourceprovider maakt een Azure Resource Manager interface. Met deze interface kunnen eigenaren van Azure-abonnementen IoT-hubs maken en verwijderen en de eigenschappen van de IoT-hub bijwerken. IoT Hub eigenschappen bepalen het beveiligingsbeleidop hubniveau, in tegenstelling tot toegangsbeheer op apparaatniveau, en functionele opties voor cloud-naar-apparaat- en apparaat-naar-cloud-berichten. Met IoT Hub resourceprovider kunt u ook apparaat-id's exporteren.

  • Apparaatidentiteitsbeheer. Elke IoT-hub toont een set HTTPS REST-eindpunten voor het beheren van apparaatidentiteiten (maken, ophalen, bijwerken en verwijderen). Apparaat-id's worden gebruikt voor apparaatverificatie en toegangsbeheer.

  • Beheer van apparaattweeling. Elke IoT-hub geeft een set service-gerichte HTTPS REST-eindpunten weer om apparaat-tweelingen op te vragen en bij te werken (updatetags en eigenschappen).

  • Takenbeheer. Elke IoT-hub toont een set service-gerichte HTTPS REST-eindpunten voor het uitvoeren van query's en het beheren van taken.

  • Apparaat-eindpunten. Voor elk apparaat in het identiteitsregister IoT Hub een set eindpunten. Behalve waar vermeld, worden deze eindpunten blootgesteld met behulp van MQTT v3.1.1,HTTPS 1.1 en AMQP 1.0-protocollen. AMQP en MQTT zijn ook beschikbaar via WebSockets op poort 443.

    • Apparaat-naar-cloud-berichten verzenden. Een apparaat gebruikt dit eindpunt om apparaat-naar-cloud-berichten te verzenden.

    • Cloud-naar-apparaat-berichten ontvangen. Een apparaat gebruikt dit eindpunt om gerichte cloud-naar-apparaat-berichten te ontvangen.

    • Bestanduploads initiëren. Een apparaat gebruikt dit eindpunt om een sas-URI Azure Storage ontvangen van IoT Hub om een bestand te uploaden.

    • Haal de eigenschappen van de apparaattweeling op en werk deze bij. Een apparaat gebruikt dit eindpunt om toegang te krijgen tot de eigenschappen van deapparaat dubbel. HTTPS wordt niet ondersteund.

    • Aanvragen voor directe methoden ontvangen. Een apparaat gebruikt dit eindpunt om te luisteren naar aanvragen vande directe methode. HTTPS wordt niet ondersteund.

    Belangrijk

    De volgende functionaliteit voor apparaten die gebruikmaken van verificatie met X.509-certificeringsinstantie (CA) is nog niet algemeen beschikbaar en de preview-modus moet zijn ingeschakeld:

    • HTTPS, MQTT via WebSockets en AMQP via WebSockets-protocollen.
    • Bestand uploaden (alle protocollen).

    Deze is algemeen beschikbaar op apparaten die gebruikmaken van X.509-vingerafdrukverificatie. Zie Ondersteunde X.509-certificaten voor meer informatie over X.509-verificatie met IoT Hub.

  • Service-eindpunten. Elke IoT-hub toont een set eindpunten voor de back-end van uw oplossing om te communiceren met uw apparaten. Met één uitzondering worden deze eindpunten alleen beschikbaar gesteld met behulp van de AMQP en AMQP via WebSockets-protocollen. Het eindpunt voor het aanroepen van directe methoden wordt via het HTTPS-protocol blootgesteld.

    • Apparaat-naar-cloud-berichten ontvangen. Dit eindpunt is compatibel met Azure Event Hubs. Een back-endservice kan deze gebruiken om de apparaat-naar-cloud-berichten te lezen die door uw apparaten worden verzonden. U kunt naast dit ingebouwde eindpunt ook aangepaste eindpunten maken op uw IoT-hub.

    • Cloud-naar-apparaat-berichten verzenden en leveringsbevestigingen ontvangen. Met deze eindpunten kan de back-end van uw oplossing betrouwbare cloud-naar-apparaat-berichtenverzenden en de bijbehorende bevestigingen voor levering of verloop ontvangen.

    • Bestandsmeldingen ontvangen. Met dit berichteindpunt kunt u meldingen ontvangen van wanneer uw apparaten een bestand uploaden.

    • Directe methode-aanroep. Met dit eindpunt kan een back-endservice een directe methode op een apparaat aanroepen.

    • Gebeurtenissen voor het bewaken van bewerkingen ontvangen. Met dit eindpunt kunt u bewakingsgebeurtenissen voor bewerkingen ontvangen als uw IoT-hub is geconfigureerd om ze te zenden. Zie Bewerkingen bewaken voor IoT Hub meer informatie.

In het artikel Azure IoT SDK's worden de verschillende manieren beschreven om toegang te krijgen tot deze eindpunten.

Alle IoT Hub gebruiken het TLS-protocol en er wordt nooit een eindpunt beschikbaar gemaakt op niet-versleutelde/onbeveiligde kanalen.

Aangepaste eindpunten

U kunt bestaande Azure-services in uw Azure-abonnementen koppelen aan uw IoT-hub om te fungeren als eindpunten voor berichtroutering. Deze eindpunten fungeren als service-eindpunten en worden gebruikt als sinks voor berichtroutes. Apparaten kunnen niet rechtstreeks naar de extra eindpunten schrijven. Meer informatie over berichtroutering.

IoT Hub ondersteunt momenteel de volgende Azure-services als extra eindpunten:

  • Azure Storage containers
  • Event Hubs
  • Service Bus-wachtrijen
  • Service Bus-onderwerpen

Zie Quota en beperking voor de limieten voor het aantal eindpunten dat u kunt toevoegen.

Endpoint Health

U kunt de REST API status van eind punt ophalen gebruiken om de status van de eind punten op te halen. We raden u aan om de IOT hub routerings gegevens met betrekking tot de latentie van de route ring te gebruiken om fouten op te sporen en op te sporen wanneer de status van het eind punt inactief of beschadigd is, omdat er een latentie wordt verwacht wanneer het eind punt in een van deze statussen wordt weer gegeven. Zie IOT hub bewakenvoor meer informatie over het gebruik van IOT hub metrische gegevens.

Status Description
blijft Het eind punt accepteert berichten zoals verwacht.
slechte Het eind punt accepteert geen berichten en IoT Hub probeert berichten naar dit eind punt te verzenden.
unknown IoT Hub heeft niet geprobeerd berichten te leveren aan dit eind punt.
gedegradeerd Het eind punt accepteert berichten die langzamer zijn dan verwacht of worden hersteld vanaf een slechte status.
geval IoT Hub levert geen berichten meer aan dit eind punt. Poging tot het verzenden van berichten naar dit eind punt is mislukt.

Veldgateways

In een IoT-oplossing bevindt een veldgateway zich tussen uw apparaten en IoT Hub eindpunten. Deze bevindt zich doorgaans dicht bij uw apparaten. Uw apparaten communiceren rechtstreeks met de veldgateway met behulp van een protocol dat wordt ondersteund door de apparaten. De veldgateway maakt verbinding met IoT Hub eindpunt met behulp van een protocol dat wordt ondersteund door IoT Hub. Een veldgateway kan een toegewezen hardwareapparaat of een computer met weinig vermogen zijn met aangepaste gatewaysoftware.

U kunt een Azure IoT Edge om een veldgateway te implementeren. IoT Edge biedt functionaliteit zoals multiplexing van communicatie van meerdere apparaten naar dezelfde IoT Hub verbinding.

Volgende stappen

Andere naslagonderwerpen in IoT Hub ontwikkelaarshandleiding zijn: