Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Hinzufügen von Propagierungsattributen für die Nachrichtenanreicherung In können Sie MQTT-Nachrichten von Geräten anreichern AWS IoT Core, indem Sie propagierende Attribute hinzufügen, bei denen es sich um kontextbezogene Metadaten aus Dingattributen oder Verbindungsdetails handelt. Dieser Prozess, bekannt als Nachrichtenanreicherung, kann in verschiedenen Szenarien hilfreich sein. Sie können beispielsweise Nachrichten für jeden eingehenden Veröffentlichungsvorgang anreichern, ohne Änderungen auf der Geräteseite vorzunehmen oder Regeln verwenden zu müssen. Durch die Nutzung von propagierenden Attributen können Sie von einer effizienteren und kostengünstigeren Methode zur Anreicherung Ihrer IoT-Daten profitieren, ohne die Komplexität der Konfiguration von Regeln oder der Verwaltung von Konfigurationen für die Neuveröffentlichung. [https://docs.aws.amazon.com//iot/latest/developerguide/iot-basic-ingest.html](https://docs.aws.amazon.com//iot/latest/developerguide/iot-basic-ingest.html) Es ist wichtig zu beachten, dass Publishing-Geräte zwar jede MQTT-Version verwenden können, Abonnenten (Anwendungen oder Dienste, die Nachrichten konsumieren) jedoch [MQTT 5](https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html) unterstützen müssen, um die angereicherten Nachrichten mit propagierenden Attributen zu empfangen. Die angereicherten Nachrichten werden als MQTT 5-Benutzereigenschaften zu jeder Nachricht hinzugefügt, die von Geräten veröffentlicht wird. Wenn Sie [Regeln](https://docs.aws.amazon.com//iot/latest/developerguide/iot-rules.html) verwenden, können Sie die Funktion [get\$1user\$1properties](https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-user-properties) nutzen, um die angereicherten Daten für das Routing oder die Verarbeitung von Nachrichten auf der Grundlage der Daten abzurufen. In können Sie propagierende Attribute hinzufügen AWS IoT Core, wenn Sie einen Dingtyp erstellen oder aktualisieren, indem Sie den oder den verwenden. AWS-Managementkonsole AWS CLI **Wichtig** Beim Hinzufügen von Übertragungsattributen müssen Sie sicherstellen, dass der Client, der die Nachricht veröffentlicht, mit einem Zertifikat authentifiziert wurde. Weitere Informationen finden Sie unter [Client-Authentifizierung](client-authentication.md). **Anmerkung** Wenn Sie versuchen, diese Funktion mit dem MQTT-Testclient in der Konsole zu testen, funktioniert es möglicherweise nicht, da für diese Funktion MQTT-Clients erforderlich sind, die mit einem zugehörigen Zertifikat authentifiziert sind. ## AWS-Managementkonsole **Um propagierende Attribute für die Nachrichtenanreicherung hinzuzufügen, verwenden Sie AWS-Managementkonsole** 1. Öffnen Sie die [AWS IoT Startseite](https://console.aws.amazon.com//iot/home#/home) in der AWS IoT Konsole. Wählen Sie in der linken Navigationsleiste unter **Verwalten** die Option **Alle Geräte** aus. Wählen Sie dann „**Dingtypen**“. 1. Wählen Sie auf **der Seite Dingtypen** die Option **Dingtyp erstellen** aus. Um die Nachrichtenanreicherung durch Aktualisierung eines Dingtyps zu konfigurieren, wählen Sie einen Dingtyp aus. Wählen Sie dann auf der Detailseite des Dingtyps die Option **Aktualisieren** aus. 1. Wählen Sie auf der Seite **Dingtyp erstellen** unter **Eigenschaften des Dingtyps die Informationen zum Dingtyp aus,** oder geben Sie sie ein. Wenn Sie einen Dingtyp aktualisieren möchten, werden die **Eigenschaften des Dingtyps** angezeigt, nachdem Sie im vorherigen Schritt „**Aktualisieren**“ ausgewählt haben. 1. Erweitern Sie **unter Zusätzliche Konfiguration** den **Eintrag Attribute weitergeben**. Wählen Sie dann **Ding-Attribut** und geben Sie das Ding-Attribut ein, das Sie in die veröffentlichten MQTT5 Nachrichten aufnehmen möchten. Mithilfe der Konsole können Sie bis zu drei Ding-Attribute hinzufügen. Wählen Sie im **Abschnitt Attribute weitergeben** die Option **Verbindungsattribut** aus und geben Sie den Attributtyp und optional den Attributnamen ein. 1. Fügen Sie optional Tags hinzu. Wählen Sie dann „**Dingtyp erstellen**“. Wenn Sie einen Dingtyp aktualisieren möchten, wählen Sie **Dingtyp aktualisieren**. ## AWS CLI 1. Um propagierende Attribute für die Nachrichtenanreicherung hinzuzufügen, indem Sie mit dem einen neuen Dingtyp erstellen AWS CLI, führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html)Befehl aus. Ein Beispielbefehl kann der folgende sein. ``` aws iot create-thing-type \ --thing-type-name "LightBulb" \ --thing-type-properties "{\"mqtt5Configuration\":{\"propagatingAttributes\":[{\"userPropertyKey\":\"iot:ClientId\", \"connectionAttribute\":\"iot:ClientId\"}, {\"userPropertyKey\":\"test\", \"thingAttribute\":\"A\"}]}}" \ ``` Die Ausgabe des Befehls kann wie folgt aussehen. ``` { "thingTypeName": "LightBulb", "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb", "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190" } ``` 1. Führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-type.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-type.html)Befehl aus, um die Nachrichtenanreicherung durch Aktualisierung eines Dingtyps mithilfe AWS CLI zu konfigurieren. Beachten Sie, dass Sie nur aktualisieren können`mqtt5Configuration`, wenn Sie diesen Befehl ausführen. Ein Beispielbefehl kann der folgende sein. ``` aws iot update-thing-type \ --thing-type-name "MyThingType" \ --thing-type-properties "{\"mqtt5Configuration\":{\"propagatingAttributes\":[{\"userPropertyKey\":\"iot:ClientId\", \"connectionAttribute\":\"iot:ClientId\"}, {\"userPropertyKey\":\"test\", \"thingAttribute\":\"A\"}]}}" \ ``` Dieser Befehl liefert keine Ausgabe. 1. Um einen Ding-Typ zu beschreiben, führen Sie den `describe-thing-type` Befehl aus. Dieser Befehl erzeugt eine Ausgabe mit den Konfigurationsinformationen zur Nachrichtenanreicherung im `thing-type-properties` Feld. Ein Beispielbefehl kann der folgende sein. ``` aws iot describe-thing-type \ --thing-type-name "LightBulb" ``` Die Ausgabe kann wie folgt aussehen. ``` { "thingTypeName": "LightBulb", "thingTypeId": "bdf72512-0116-4392-8d79-bf39b17ef73d", "thingTypeArn": "arn:aws:iot:us-east-1:123456789012:thingtype/LightBulb", "thingTypeProperties": { "mqtt5Configuration": { "propagatingAttributes": [ { "userPropertyKey": "iot:ClientId", "connectionAttribute": "iot:ClientId" }, { "userPropertyKey": "test", "thingAttribute": "attribute" } ] } }, "thingTypeMetadata": { "deprecated": false, "creationDate": "2024-10-18T17:37:46.656000+00:00" } } ``` Weitere Informationen finden Sie unter [Objekttypen](thing-types.md).