AWS IoT
Entwicklerhandbuch

Themen

Der Message Broker verwendet Topics, um Nachrichten von veröffentlichenden Clients an Abonnement-Clients zu senden. Mit einem Slash (/) werden Topics hierarchisch unterteilt.

Anmerkung

Es wird nicht empfohlen, für Themen personenbezogene Informationen zu verwenden.

In der folgenden Tabelle sind Platzhalter aufgelistet, mit denen Sie Topics beim Abonnieren filtern können.

Topic-Platzhalter

Platzhalter Beschreibung
#

Die Raute ist das letzte Zeichen in einem Topic, das Sie abonnieren. Der Platzhalter sucht nach Übereinstimmungen in der aktuellen Struktur und allen untergeordneten Strukturen. Wenn Sie beispielsweise das Topic Sensor/# abonnieren, erhalten Sie Nachrichten, die für Sensor/, Sensor/temp oder Sensor/temp/room1 veröffentlicht werden, nicht jedoch Nachrichten, die für Sensor veröffentlicht werden.

+

Dieser Platzhalter steht für genau ein Element in der Topic-Hierarchie. Wenn Sie beispielsweise das Topic Sensor/+/room1 abonnieren, erhalten Sie Nachrichten, die für Sensor/temp/room1, Sensor/moisture/room1 usw. veröffentlicht werden.

Reservierte Topics

Abgesehen von den unten aufgeführten Topics gelten alle Topics beginnend mit "$" als reserviert und werden nicht für die Veröffentlichung und Abonnements unterstützt. Wenn Sie versuchen, für ein Topic, das mit "$" beginnt, etwas zu veröffentlichen oder das Topic zu abonnieren, wird die Verbindung getrennt.

Ereignis-Topics

Topic Zulässige Operationen Beschreibung

$aws/events/presence/connected/clientId

Abonnieren

AWS IoT veröffentlicht die Nachricht in diesem Thema, wenn ein MQTT-Client mit der angegebenen Client-ID eine Verbindung zu AWS IoT herstellt. Weitere Informationen finden Sie unter Ereignis "Verbinden/Verbindung trennen".

$aws/events/presence/disconnected/clientId

Abonnieren

AWS IoT veröffentlicht die Nachricht in diesem Thema, wenn ein MQTT-Client mit der angegebenen Client-ID eine Verbindung zu AWS IoT trennt. Weitere Informationen finden Sie unter Ereignis "Verbinden/Verbindung trennen".

$aws/events/subscriptions/subscribed/clientId

Abonnieren

AWS IoT veröffentlicht die Nachricht in diesem Thema, wenn ein MQTT-Client mit der angegebenen Client-ID das MQTT-Thema abonniert. Weitere Informationen finden Sie unter Ereignis "Abonnieren/Abonnement abbestellen".

$aws/events/subscriptions/unsubscribed/clientId

Abonnieren

AWS IoT veröffentlicht die Nachricht in diesem Thema, wenn ein MQTT-Client mit der angegebenen Client-ID das Abonnement für dieses MQTT-Thema abbestellt. Weitere Informationen siehe Ereignis "Abonnieren/Abonnement abbestellen".

Regel-Topics

Topic Zulässige Operationen Beschreibung

$aws/rules/ruleName

Veröffentlichen

Ein Gerät oder eine Anwendung veröffentlicht in diesem Thema, um Regeln direkt auszulösen. Weitere Informationen finden Sie unter Basic Ingest.

Thing Shadow-Topics

Topic Zulässige Operationen Beschreibung

$aws/things/<thingName>/shadow/delete

Veröffentlichen/Abonnieren

Ein Gerät oder eine Anwendung veröffentlicht in diesem Thema, um ein Schattengerät zu löschen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#delete-pub-sub-topic.

$aws/things/<thingName>/shadow/delete/accepted

Subscribe

Der Device Shadow-Service sendet Nachrichten an dieses Thema, wenn ein Schattengerät gelöscht wird. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#delete-accepted-pub-sub-topic.

$aws/things/<thingName>/shadow/delete/rejected

Subscribe

Der Device Shadow-Service sendet Nachrichten an dieses Thema, wenn ein Anfrage zum Löschen eines Schattengeräts abgelehnt wird. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#delete-rejected-pub-sub-topic.

$aws/things/<thingName>/shadow/get

Veröffentlichen/Abonnieren

Eine Anwendung oder ein Gerät veröffentlicht eine leere Nachricht für dieses Thema, um ein Schattengerät zugewiesen zu bekommen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html.

$aws/things/<thingName>/shadow/get/accepted

Subscribe

Der Device Shadow-Service sendet Nachrichten an dieses Thema, wenn ein Anfrage für ein Schattengerät erfolgreich war. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#get-accepted-pub-sub-topic.

$aws/things/<thingName>/shadow/get/rejected

Subscribe

Der Device Shadow-Service sendet Nachrichten an dieses Thema, wenn ein Anfrage für ein Schattengerät abgelehnt wird. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#get-rejected-pub-sub-topic.

$aws/things/<thingName>/shadow/update

Veröffentlichen/Abonnieren

Ein Gerät oder eine Anwendung veröffentlicht eine Nachricht in diesem Thema, um ein Schattengerät zu aktualisieren. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#update-pub-sub-topic.

$aws/things/<thingName>/shadow/update/accepted

Subscribe

Der Device Shadow-Service sendet Nachrichten an dieses Thema, wenn ein Schattengerät erfolgreich aktualisiert wurde. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#update-accepted-pub-sub-topic.

$aws/things/<thingName>/shadow/update/rejected

Subscribe

Der Device Shadow-Service sendet Nachrichten an dieses Thema, wenn die Aktualisierung eines Schattengeräts abgelehnt wurde. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#update-rejected-pub-sub-topic.

$aws/things/<thingName>/shadow/update/delta

Subscribe

Der Device Shadow-Service sendet Nachrichten an dieses Thema, wenn zwischen den gemeldeten und gewünschten Abschnitten eines Schattengeräts Abweichungen auftreten. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#update-delta-pub-sub-topic.

$aws/things/<thingName>/shadow/update/documents

Subscribe

AWS IoT veröffentlicht immer dann ein Statusdokument zu diesem Thema, wenn das Schattengerät erfolgreich aktualisiert wurde. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html#update-documents-pub-sub-topic.

Job-Topics

Topic Zulässige Operationen Beschreibung

$aws/things/<thingName>/jobs/get

Veröffentlichen

Geräte veröffentlichen eine Nachricht in diesem Topic, um eine GetPendingJobExecutions-Anforderung auszugeben. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/get/accepted

Subscribe

Geräte abonnieren dieses Topic, um Antworten von einer GetPendingJobExecutions-Anforderung zu empfangen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/get/accepted

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine GetPendingJobExecutions-Anforderung zu empfangen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/start-next

Veröffentlichen

Geräte veröffentlichen eine Nachricht in diesem Topic, um eine StartNextPendingJobExecution-Anforderung auszugeben. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/start-next/accepted

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine StartNextPendingJobExecution-Anforderung zu empfangen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/start-next/rejected

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine StartNextPendingJobExecution-Anforderung empfangen zu können. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/jobId/get

Veröffentlichen

Geräte veröffentlichen eine Nachricht in diesem Topic, um eine DescribeJobExecution-Anforderung auszugeben. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/<jobId>/get/accepted

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine DescribeJobExecution-Anforderung zu empfangen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/<jobId>/get/rejected

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine DescribeJobExecution-Anforderung zu empfangen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/<jobId>/update

Veröffentlichen

Geräte veröffentlichen eine Nachricht in diesem Topic, um eine UpdateJobExecution-Anforderung auszugeben. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/<jobId>/update/accepted

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine UpdateJobExecution-Anforderung zu empfangen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/<jobId>/update/rejected

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine UpdateJobExecution-Anforderung zu empfangen. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/notify

Subscribe

Geräte abonnieren dieses Thema, um Benachrichtigungen zu empfangen, wenn eine Auftragsausführung der Liste der ausstehenden Ausführungen für ein Objekt hinzugefügt oder aus dieser entfernt wird. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/things/<thingName>/jobs/notify-next

Subscribe

Geräte abonnieren dieses Thema, um Benachrichtigungen zu empfangen, wenn die nächste ausstehende Auftragsausführung für das Objekt geändert wird. Weitere Informationen siehe https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html.

$aws/events/job/<jobId>/completed

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn ein Auftrag abgeschlossen wird. Weitere Informationen siehe Auftragsereignisse.

$aws/events/job/<jobId>/canceled

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn ein Auftrag abgebrochen wird. Weitere Informationen siehe Auftragsereignisse.

$aws/events/job/<jobId>/deleted

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn ein Auftrag gelöscht wird. Weitere Informationen siehe Auftragsereignisse.

$aws/events/job/<jobId>/cancellation_in_progress

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn eine Auftragsstornierung beginnt. Weitere Informationen siehe Auftragsereignisse.

$aws/events/job/<jobId>/deletion_in_progress

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn eine Auftragslöschung beginnt. Weitere Informationen siehe Auftragsereignisse.

$aws/events/jobExecution/<jobId>/succeeded

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn der Auftrag erfolgreich ausgeführt wurde. Weitere Informationen siehe Auftragsereignisse.

$aws/events/jobExecution/<jobId>/failed

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn eine Auftragsausführung fehlschlägt. Weitere Informationen siehe Auftragsereignisse.

$aws/events/jobExecution/<jobId>/rejected

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn eine Auftragsausführung abgewiesen wird. Weitere Informationen siehe Auftragsereignisse.

$aws/events/jobExecution/<jobId>/canceled

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn eine Auftragsausführung storniert wird. Weitere Informationen siehe Auftragsereignisse.

$aws/events/jobExecution/<jobId>/timed_out

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn eine Zeitüberschreitung der Auftragsausführung auftritt. Weitere Informationen siehe Auftragsereignisse.

$aws/events/jobExecution/<jobId>/removed

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn eine Auftragsausführung entfernt wird. Weitere Informationen siehe Auftragsereignisse.

$aws/events/jobExecution/<jobId>/deleted

Subscribe

Der Jobs-Service veröffentlicht ein Ereignis in diesem Topic, wenn eine Auftragsausführung gelöscht wird. Weitere Informationen siehe Auftragsereignisse.

Auf dieser Seite: