Erstellen und Lesen von IoT Hub-Nachrichten

Zur Unterstützung der protokollübergreifenden Interoperabilität definiert IoT Hub eine Gruppe von Messagingfeatures, die in allen gerätebezogenen Protokollen verfügbar sind. Diese Features können sowohl für Gerät-zu-Cloud-Nachrichten als auch für Cloud-zu-Gerät-Nachrichten verwendet werden.

IoT Hub implementiert das D2C-Messaging anhand eines Streaming-Messagingmusters. Die Gerät-zu-Cloud-Nachrichten von IoT Hub sind eher mit Event Hubs-Ereignissen vergleichbar als mit Service Bus-Nachrichten, da der Dienst von einem größeren Volumen von Ereignissen durchlaufen wird, die von mehreren Lesern gelesen werden können.

Eine IoT Hub-Nachricht enthält Folgendes:

• Vordefinierter Satz von Systemeigenschaften (wie später in diesem Artikel beschrieben)

• Einen Satz an Anwendungseigenschaften. Ein Wörterbuch mit Zeichenfolgeneigenschaften. Die Anwendung kann diese definieren und darauf zugreifen, ohne den Nachrichtentext deserialisieren zu müssen. IoT Hub ändert diese Eigenschaften nie.

• Einen Nachrichtentext, der jede beliebige Art von Daten sein kann.

Jedes Geräteprotokoll implementiert Einstellungseigenschaften auf unterschiedliche Weise. Weitere Informationen für Entwickler finden Sie im MQTT-Protokollleitfaden und im AMQP-Protokollleitfaden.

Wenn Sie Gerät-zu-Cloud-Nachrichten mithilfe des HTTPS-Protokolls oder Cloud-zu-Gerät-Nachrichten senden, können Eigenschaftsnamen und -werte nur alphanumerische ASCII-Zeichen und ! # $ % & ' * + - . ^ _ ` | ~ enthalten.

D2C-Messaging mit IoT Hub weist folgende Merkmale auf:

• D2C-Nachrichten sind dauerhafter Art und werden bis zu sieben Tage lang auf dem Standardendpunkt der IoT Hub-Instanz (messages/events) aufbewahrt.

• D2C-Nachrichten dürfen maximal 256 KB groß sein. Sie können in Batches gruppiert werden, um den Sendevorgang zu optimieren. Die Batches können maximal 256 KB groß sein.

• IoT Hub erlaubt keine beliebige Partitionierung. D2C-Nachrichten werden gemäß ihrer ursprünglichen deviceIdpartitioniert.

• Wie in Verwalten des Zugriffs auf IoT Hub erläutert, ermöglicht IoT Hub Authentifizierung und Zugriffssteuerung auf Gerätebasis.

• Sie können Nachrichten mit Informationen stempeln, die in die Anwendungseigenschaften aufgenommen. Weitere Informationen finden Sie unter Nachrichtenanreicherungen bei Gerät-zu-Cloud-IoT Hub-Nachrichten.

Um Ihren Nachrichtentext in einer IoT Hub-Routingabfrage zu verwenden, geben Sie ein gültiges JSON-Objekt für die Nachricht an, und legen Sie die Inhaltstypeigenschaft der Nachricht auf application/json;charset=utf-8.

Das folgende Beispiel zeigt einen gültigen, routingfähigen Nachrichtentext:

{
    "timestamp": "2022-02-08T20:10:46Z",
    "tag_name": "spindle_speed",
    "tag_value": 100
}

Systemeigenschaften von Gerät-zu-Cloud-Nachrichten

Anwendungseigenschaften von Gerät-zu-Cloud-Nachrichten

Anwendungseigenschaften werden häufig verwendet, um mithilfe der Eigenschaft iothub-creation-time-utc einen Zeitstempel vom Gerät zu senden. So wird aufgezeichnet, wann die Nachricht vom Gerät gesendet wurde. Das Format dieses Zeitstempels muss UTC ohne Zeitzoneninformationen sein. Beispiel: 2021-04-21T11:30:16Z ist gültig, 2021-04-21T11:30:16-07:00 jedoch ungültig.

{
  "applicationId":"00001111-aaaa-2222-bbbb-3333cccc4444",
  "messageSource":"telemetry",
  "deviceId":"sample-device-01",
  "schema":"default@v1",
  "templateId":"urn:modelDefinition:mkuyqxzgea:e14m1ukpn",
  "enqueuedTime":"2021-01-29T16:45:39.143Z",
  "telemetry":{
    "temperature":8.341033560421833
  },
  "messageProperties":{
    "iothub-creation-time-utc":"2021-01-29T16:45:39.021Z"
  },
  "enrichments":{}
}

Systemeigenschaften von Cloud-zu-Gerät-Nachrichten

Namen von Systemeigenschaften

Die Namen von Systemeigenschaften variieren je nach dem Endpunkt, an den die Nachrichten weitergeleitet werden.

Nachrichtengröße

IoT Hub misst die Nachrichtengröße auf „protokollagnostische“ Weise, indem nur die tatsächliche Nutzlast berücksichtigt wird. Die Größe in Byte wird als Summe der folgenden Werte berechnet:

• Text in Byte
• Größe aller Werte der Nachrichtensystemeigenschaften in Byte
• Größe aller Benutzereigenschaftsnamen und -werte in Byte

Die Eigenschaftennamen und -werte sind auf ASCII-Zeichen beschränkt, sodass die Länge der Zeichenfolgen der Größe in Byte entspricht.

Eigenschaften zum Schutz vor Spoofing

Um ein Gerätespoofing beim D2C-Messaging zu verhindern, versieht IoT Hub alle Nachrichten mit den folgenden Eigenschaften:

• iothub-connection-device-id
• iothub-connection-auth-generation-id
• iothub-connection-auth-method

Die ersten beiden Eigenschaften enthalten die Werte für deviceId und generationId des ursprünglichen Geräts, wie unter Geräteidentitätseigenschaften beschrieben.

Die Eigenschaft iothub-connection-auth-method enthält ein serialisiertes JSON-Objekt mit folgenden Eigenschaften:

{
  "scope": "{ hub | device | module }",
  "type": "{ symkey | sas | x509 }",
  "issuer": "iothub"
}

Nächste Schritte

• Informationen zu Größenbeschränkungen für Nachrichten in IoT Hub finden Sie unter IoT Hub-Kontingente und -Drosselung.
• Informationen zum Erstellen und Lesen von IoT Hub-Nachrichten in verschiedenen Programmiersprachen finden Sie in den Schnellstartanleitungen.
• Informationen zur Struktur von nicht telemetriebezogenen Ereignissen, die von IoT Hub generiert werden, finden Sie unter IoT Hub non-telemetry event schemas (Schemas von IoT Hub für nicht telemetriebezogene Ereignisse).