Skapa och läsa IoT Hub-meddelanden

För att stödja samverkan mellan protokoll definierar IoT Hub en gemensam uppsättning meddelandefunktioner som är tillgängliga i alla enhetsriktade protokoll. Dessa funktioner kan användas i både enhet-till-moln-meddelanden och moln-till-enhet-meddelanden.

IoT Hub implementerar meddelanden från enhet till moln med hjälp av ett mönster för strömmande meddelanden. IoT Hubs meddelanden från enhet till moln är mer som Event Hubs-händelser än Service Bus-meddelanden, eftersom det finns en stor mängd händelser som passerar genom tjänsten som flera läsare kan läsa.

Ett IoT Hub-meddelande består av:

• En fördefinierad uppsättning systemegenskaper enligt beskrivningen senare i den här artikeln.

• En uppsättning programegenskaper. En ordlista med strängegenskaper som programmet kan definiera och komma åt, utan att behöva deserialisera meddelandetexten. IoT Hub ändrar aldrig dessa egenskaper.

• En meddelandetext, som kan vara vilken typ av data som helst.

Varje enhetsprotokoll implementerar inställningsegenskaper på olika sätt. Mer information finns i Kommunicera med en IoT-hubb med MQTT-protokollet och Kommunicera med din IoT-hubb med hjälp av AMQP-protokollet.

När du skickar meddelanden från enhet till moln med hjälp av HTTPS-protokollet eller skickar meddelanden från moln till enhet kan egenskapsnamn och värden endast innehålla alfanumeriska ASCII-tecken plus ! # $ % & ' * + - . ^ _ ` | ~ .

Meddelanden från enhet till moln med IoT Hub har följande egenskaper:

• Meddelanden från enhet till moln är hållbara och behålls i en IoT-hubbs standardslutpunkt för meddelanden/händelser i upp till sju dagar.

• Meddelanden från enhet till moln kan vara högst 256 KB och kan grupperas i batchar för att optimera sändningarna. Batchar kan vara högst 256 KB.

• IoT Hub tillåter inte godtycklig partitionering. Meddelanden från enhet till moln partitioneras baserat på deras ursprungliga deviceId.

• Som beskrivs i Kontrollera åtkomst till IoT Hub med hjälp av Microsoft Entra-ID aktiverar IoT Hub autentisering per enhet och åtkomstkontroll.

• Du kan stämpla meddelanden med information som går in i programegenskaperna. Mer information finns i Meddelandeberikanden för IoT Hub-meddelanden från enhet till moln.

Om du vill använda meddelandetexten i en IoT Hub-routningsfråga anger du ett giltigt JSON-objekt för meddelandet och anger innehållets typegenskap till application/json;charset=utf-8.

I följande exempel visas en giltig, dirigerbar meddelandetext:

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

Systemegenskaper för meddelanden från enhet till moln

Programegenskaper för meddelanden från enhet till moln

En vanlig användning av programegenskaper är att skicka en tidsstämpel från enheten med hjälp av iothub-creation-time-utc egenskapen för att registrera när enheten skickar meddelandet. Formatet för den här tidsstämpeln måste vara UTC utan tidszonsinformation. Är till exempel 2021-04-21T11:30:16Z giltigt, men 2021-04-21T11:30:16-07:00 är ogiltigt.

{
  "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":{}
}

Systemegenskaper för meddelanden från moln till enhet

Namn på systemegenskap

Namnen på systemegenskapen varierar beroende på den slutpunkt som meddelandena dirigeras till.

Meddelandestorlek

IoT Hub mäter meddelandestorleken på ett protokolloberoende sätt med tanke på den faktiska nyttolasten. Storleken i byte beräknas som summan av följande värden:

• Kroppsstorleken i byte.
• Storleken i byte för alla värden för meddelandesystemets egenskaper.
• Storleken i byte för alla användaregenskapsnamn och värden.

Egenskapsnamn och värden är begränsade till ASCII-tecken, så längden på strängarna är lika med storleken i byte.

Egenskaper för skydd mot förfalskning

För att undvika enhetsförfalskning i meddelanden från enhet till moln stämplar IoT Hub alla meddelanden med följande egenskaper:

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

De första två innehåller deviceId och generationId för den ursprungliga enheten, enligt egenskaper för enhetsidentitet.

Egenskapen iothub-connection-auth-method innehåller ett JSON-serialiserat objekt med följande egenskaper:

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

Nästa steg

• För information om gränser för meddelandestorlek i IoT Hub, se IoT Hub-kvoter och begränsningar.
• Information om hur du skapar och läser IoT Hub-meddelanden på olika programmeringsspråk finns i Självstudie: Skicka telemetri från en IoT Plug and Play-enhet till Azure IoT Hub.
• Mer information om strukturen för icke-telemetrihändelser som genereras av IoT Hub finns i Händelsescheman för icke-telemetri i Azure IoT Hub.