View a markdown version of this page

Hinzufügen von Propagierungsattributen für die Nachrichtenanreicherung - AWS IoT Core
AWS-ManagementkonsoleAWS CLI

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 Propagierungsattribute hinzufügen, bei denen es sich um kontextbezogene Metadaten aus Dingattributen oder Verbindungsdetails handelt. Dieser als Nachrichtenanreicherung bekannte Prozess kann in verschiedenen Szenarien hilfreich sein. Beispielsweise können Sie Nachrichten für jeden eingehenden Veröffentlichungsvorgang anreichern, ohne dass Sie dabei geräteseitige Änderungen vornehmen oder Regeln verwenden müssen. Durch die Nutzung von Propagierungsattributen können Sie Ihre IoT-Daten effizienter und kostengünstiger anreichern, ohne dass Sie Regeln konfigurieren oder Konfigurationen erneut veröffentlichen müssen.

Die Funktion zur Nachrichtenanreicherung steht AWS IoT Core Kunden zur Verfügung, die Basic Ingest und Message Broker verwenden. https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html Es ist wichtig zu beachten, dass Veröffentlichungsgeräte zwar jede MQTT-Version verwenden können, Abonnenten (Anwendungen oder Dienste, die Nachrichten konsumieren) jedoch MQTT 5 unterstützen müssen, um die angereicherten Nachrichten mit Propagierungsattributen zu empfangen. Die angereicherten Nachrichten werden jeder Nachricht, die von Geräten veröffentlicht wird, als MQTT 5-Benutzereigenschaften hinzugefügt. Wenn Sie Regeln verwenden, können Sie die Funktion get_user_properties nutzen, um die angereicherten Daten für die Nachrichtenweiterleitung oder -verarbeitung auf der Grundlage der Daten abzurufen.

In können Sie Propagierungsattribute hinzufügen AWS IoT Core, wenn Sie einen Dingtyp erstellen oder aktualisieren, indem Sie die oder verwenden. AWS-Managementkonsole AWS CLI

Wichtig

Beim Hinzufügen von Propagierungsattributen müssen Sie sicherstellen, dass der Client, der die Nachricht veröffentlicht, mit einem Zertifikat authentifiziert wurde. Weitere Informationen finden Sie unter Client-Authentifizierung.

Anmerkung

Wenn Sie versuchen, diese Funktion mit dem MQTT-Testclient in der Konsole zu testen, funktioniert sie möglicherweise nicht, da für diese Funktion MQTT-Clients erforderlich sind, die mit einem zugehörigen Zertifikat authentifiziert sind.

AWS-Managementkonsole

Um Propagierungsattribute für die Nachrichtenanreicherung hinzuzufügen, verwenden Sie den AWS-Managementkonsole

  1. Öffnen Sie die AWS IoT Startseite in der AWS IoT Konsole. Wählen Sie im linken Navigationsbereich unter Verwalten die Option Alle Geräte aus. Wählen Sie dann Dingtypen aus.

  2. 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 Seite mit den Dingtyp-Details die Option Aktualisieren aus.

  3. Wählen Sie auf der Seite „Dingtyp erstellen“ die Informationen zum Dingtyp in den Eigenschaften des Dingtyps aus, oder geben Sie sie ein.

    Wenn Sie einen Dingtyp aktualisieren möchten, werden die Eigenschaften des Dingtyps angezeigt, nachdem Sie im vorherigen Schritt auf Aktualisieren geklickt haben.

  4. Erweitern Sie unter Zusätzliche Konfiguration die Option Attribute weitergeben. Wählen Sie dann Dingattribut und geben Sie das Dingattribut ein, das Sie in die veröffentlichten MQTT5-Nachrichten eintragen möchten. Mithilfe der Konsole können Sie bis zu drei Dingattribute hinzufügen.

    Wählen Sie im Abschnitt Attribute weitergeben die Option Verbindungsattribut aus und geben Sie den Attributtyp und optional den Attributnamen ein.

  5. 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 Propagierungsattribute für die Nachrichtenanreicherung hinzuzufügen, indem Sie mithilfe von einen neuen Dingtyp erstellen AWS CLI, führen Sie den Befehl create-thing-type 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"
}

  2. Führen Sie den Befehl update-thing-type aus, um die Nachrichtenanreicherung zu konfigurieren AWS CLI, indem Sie einen Dingtyp mit aktualisieren . 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.

  3. Führen Sie den describe-thing-type Befehl aus, um einen Dingtyp zu beschreiben. Dieser Befehl erzeugt eine Ausgabe mit 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.