Referenz: IoT Hub-Endpunkte

Hinweis

Einige der in diesem Artikel erwähnten Features (wie Cloud-zu-Gerät-Messaging, Gerätezwillinge und Geräteverwaltung) stehen nur im Standard-Tarif von IoT Hub zur Verfügung. Weitere Informationen zu den IoT Hub-Tarifen „Basic“ und „Standard“ finden Sie unter Wählen des passenden IoT Hub-Tarifs für Ihre Lösung.

IoT Hub-Namen

Den Hostnamen der IoT Hub-Instanz, die Ihre Endpunkte hostet, finden Sie im Portal auf der Seite Übersicht. Standardmäßig sieht der DNS-Name einer IoT Hub-Instanz wie folgt aus: {your iot hub name}.azure-devices.net.

Liste der integrierten IoT Hub-Endpunkte

Azure IoT Hub ist ein mehrinstanzenfähiger Dienst, der seine Funktionen für zahlreiche Akteure bereitstellt. Das nachstehende Diagramm zeigt die verschiedenen Endpunkte, die von IoT Hub verfügbar gemacht werden.

IoT Hub-Endpunkte

Die Endpunkte werden in der folgende Liste beschrieben:

  • Ressourcenanbieter. Der IoT Hub-Ressourcenanbieter macht eine Azure Resource Manager-Schnittstelle verfügbar. Über diese Schnittstelle können Azure Abonnementbesitzer IoT Hub-Instanzen erstellen und löschen sowie IoT Hub-Eigenschaften aktualisieren. IoT Hub-Eigenschaften steuern Sicherheitsrichtlinien auf Hubebene (im Gegensatz zur Zugriffssteuerung auf Geräteebene) und funktionale Optionen für das Messaging zwischen Cloud und Gerät (Cloud-to-Device, C2D) sowie Gerät und Cloud (Device-to-Cloud, D2C). Der IoT Hub-Ressourcenanbieter ermöglicht außerdem das Exportieren von Geräteidentitäten.

  • Geräteidentitätsverwaltung. Jede IoT Hub-Instanz macht eine Gruppe von HTTPS-REST-Endpunkten zum Verwalten von Geräteidentitäten (zum Erstellen, Abrufen, Aktualisieren und Löschen) verfügbar. Geräteidentitäten werden zur Geräteauthentifizierung und für die Zugriffssteuerung eingesetzt.

  • Verwaltung von Gerätezwillingen. Jede IoT Hub-Instanz macht eine Gruppe von dienstseitigen HTTPS-REST-Endpunkten zum Abfragen und Aktualisieren von Gerätezwillingen (Updatetags und Eigenschaften) verfügbar.

  • Auftragsverwaltung. Jede IoT Hub-Instanz macht eine Gruppe von dienstseitigen HTTPS-REST-Endpunkten zum Abfragen und Verwalten von Aufträgen verfügbar.

  • Geräteendpunkte. Für jedes Gerät in der Identitätsregistrierung macht IoT Hub eine Reihe von Endpunkten verfügbar. Sofern nicht anders angegeben, werden diese Endpunkte über die Protokolle MQTT v3.1.1, HTTPS 1.1 und AMQP 1.0 verfügbar gemacht. AMQP und MQTT stehen auch über WebSockets an Port 443 zur Verfügung.

    • Senden von D2C-Nachrichten. Ein Gerät verwendet diesen Endpunkt, um D2C-Nachrichten zu senden.

    • Empfangen von C2D-Nachrichten. Ein Gerät verwendet diesen Endpunkt, um gezielte C2D-Nachrichten zu empfangen.

    • Einleiten von Dateiuploads. Ein Gerät verwendet diesen Endpunkt zum Empfangen eines Azure Storage-SAS-URIs von IoT Hub, um eine Datei hochzuladen.

    • Abrufen und Aktualisieren der Eigenschaften von Gerätezwillingen. Ein Gerät verwendet diesen Endpunkt für den Zugriff auf die Eigenschaften seines Gerätezwillings. HTTPS wird nicht unterstützt.

    • Empfangen von Anforderungen direkter Methoden. Ein Gerät verwendet diesen Endpunkt zum Lauschen auf Anforderungen direkter Methoden. HTTPS wird nicht unterstützt.

    Wichtig

    Die folgenden Funktionen für Geräte, die die Authentifizierung der X.509-Zertifizierungsstelle (Certificate Authority, CA) verwenden, sind noch nicht allgemein verfügbar, und der Vorschaumodus muss aktiviert werden:

    • HTTPS, MQTT über WebSockets und AMQP über WebSockets-Protokolle.
    • Dateiuploads (alle Protokolle).

    Dieses Feature ist auf Geräten, die die X.509-Fingerabdruckauthentifizierung verwenden, allgemein verfügbar. Weitere Informationen zur X.509-Authentifizierung mit IoT Hub finden Sie unter Unterstützte X.509-Zertifikate.

  • Dienstendpunkte. Jede IoT Hub-Instanz macht eine Reihe von Endpunkten verfügbar, über die Ihr Lösungs-Back-End mit Ihren Geräten kommunizieren kann. Mit einer einzigen Ausnahme werden diese Endpunkte nur über die Protokolle AMQP und „AMQP über WebSockets“ verfügbar gemacht. Der Endpunkt für den Aufruf direkter Methoden wird über das HTTPS-Protokoll verfügbar gemacht.

    • Empfangen von D2C-Nachrichten. Dieser Endpunkt ist kompatibel mit Azure Event Hubs. Ein Back-End-Dienst kann ihn zum Lesen der D2C-Nachrichten verwenden, die Ihre Geräte senden. Zusätzlich zu diesem integrierten Endpunkt können Sie für Ihren IoT-Hub benutzerdefinierte Endpunkte erstellen.

    • Senden von C2D-Nachrichten und Empfangen von Übermittlungsbestätigungen. Diese Endpunkte ermöglichen Ihrem Lösungs-Back-End das Senden von zuverlässigen C2D-Nachrichten sowie das Empfangen zugehöriger Übermittlungs- oder Ablaufbestätigungen.

    • Empfangen von Dateibenachrichtigungen. Dieser Messaging-Endpunkt ermöglicht den Empfang von Benachrichtigungen, wenn Ihre Geräte erfolgreich eine Datei hochgeladen haben.

    • Aufruf direkter Methoden. Dieser Endpunkt ermöglicht einem Back-End-Dienst das Aufrufen einer direkten Methode auf einem Gerät.

    • Empfangen von Vorgangsüberwachungsereignissen. Mit diesem Endpunkt können Sie Vorgangsüberwachungsereignisse empfangen, wenn Ihr IoT Hub für deren Ausgabe konfiguriert wurde. Weitere Informationen finden Sie unter IoT Hub-Vorgangsüberwachung.

Im Artikel Azure IoT SDKs werden die verschiedenen Möglichkeiten zum Zugriff auf diese Endpunkte beschrieben.

Alle IoT Hub-Endpunkte verwenden das TLS-Protokoll, und Endpunkte werden niemals für unverschlüsselte/unsichere Kanäle verfügbar gemacht.

Benutzerdefinierte Endpunkte

Sie können vorhandene Azure-Dienste in Ihren Azure-Abonnements mit Ihrem IoT-Hub verknüpfen, damit sie als Endpunkte für das Nachrichtenrouting fungieren. Diese Endpunkte fungieren als Dienstendpunkte und werden als Senken für Nachrichtenrouten verwendet. Geräte können nicht direkt auf die zusätzlichen Endpunkte schreiben. Erfahren Sie mehr über das Nachrichtenrouting.

IoT Hub unterstützt derzeit folgende Azure-Dienste als zusätzliche Endpunkte:

  • Azure Storage-Container
  • Event Hubs
  • Service Bus-Warteschlangen
  • Service Bus-Themen

Informationen zur Beschränkung der Anzahl von Endpunkten, die Sie hinzufügen können, finden Sie unter Kontingente und Drosselung.

Endpunktintegrität

Sie können die REST-API Get Endpoint Health (Endpunktintegrität abrufen) verwenden, um den Integritätsstatus der Endpunkte abzurufen. Die Verwendung von IoT Hub-Routingmetriken bezüglich der Latenz bei der Nachrichtenweiterleitung wird empfohlen, um Fehler zu identifizieren und zu debuggen, wenn die Integrität des Endpunkts „Inaktiv“ oder „Fehlerhaft“ lautet. Es ist zu erwarten, dass die Latenz höher ist, wenn der Endpunkt einen dieser Status aufweist. Weitere Informationen zur Verwendung von IoT Hub-Metriken finden Sie unter Überwachen von IoT Hub.

Integritätsstatus BESCHREIBUNG
healthy Der Endpunkt akzeptiert Nachrichten erwartungsgemäß.
Fehlerhaft Vom Endpunkt werden keine Nachrichten akzeptiert, und von IoT Hub wird versucht, Nachrichten erneut an diesen Endpunkt zu senden.
Unbekannt Von IoT Hub wurde nicht versucht, Nachrichten an diesen Endpunkt zu übermitteln.
Beeinträchtigt Vom Endpunkt werden Nachrichten langsamer als erwartet akzeptiert, oder der Endpunkt wird wiederhergestellt, nachdem er sich in einem fehlerhaften Zustand befand.
Inaktiv Von IoT Hub werden keine Nachrichten mehr an diesen Endpunkt übermittelt. Das erneute Senden von Nachrichten an diesen Endpunkt war nicht erfolgreich.

Bereichsgateways

Bei einer IoT-Lösung ist zwischen Ihren Geräten und IoT Hub-Endpunkten ein Bereichsgateway angeordnet. Es befindet sich normalerweise in der Nähe Ihrer Geräte. Ihre Geräte kommunizieren direkt mit dem Bereichsgateway, indem sie ein von den Geräten unterstütztes Protokoll nutzen. Das Bereichsgateway verbindet sich mit einem IoT Hub-Endpunkt über ein Protokoll, das von IoT Hub unterstützt wird. Bei einem Bereichsgateway kann es sich um ein dediziertes Hardwaregerät oder um einen energiesparenden Computer mit benutzerdefinierter Gatewaysoftware handeln.

Sie können Azure IoT Edge verwenden, um ein Bereichsgateway zu implementieren. IoT Edge ermöglicht es unter anderem, die Kommunikation mehrerer Geräte im Multiplexverfahren über die gleiche IoT Hub-Verbindung zu übertragen.

Nächste Schritte

Weitere Referenzthemen in diesem IoT Hub-Entwicklungsleitfaden: