AWS IoT
Entwicklerhandbuch

Topics

Der Message Broker verwendet Topics, um Nachrichten von veröffentlichenden Clients an Abonnement-Clients zu senden. Themen sind UTF-8-kodierte hierarchische Zeichenfolgen. Der Schrägstrich (/) wird verwendet, um Ebenen in der Themenhierarchie zu trennen. zum Beispiel:

Sensor/temperature/room1

Dieses Thema bezieht sich auf einen Temperatursensor in Raum 1.

Anmerkung

Verwenden Sie keine personenbezogenen Informationen in Ihren Themen.

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.

Der Namespace für ein Topic ist für jede Kombination aus AWS-Konto und Region individuell. Das Topic Sensor/temp/room1 für ein bestimmtes AWS-Konto ist beispielsweise unabhängig vom Topic Sensor/temp/room1 für ein anderes AWS-Konto. Dasselbe gilt für Regionen. Das Thema Sensor/temp/room1 für die Region "us-east-1" ist innerhalb desselben AWS-Kontos unabhängig von demselben Thema für die Region "us-east-2". Das Senden und Empfangen von Nachrichten über verschiedene AWS-Konten und Regionen hinweg wird in AWS IoT nicht unterstützt.

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 hierzu finden Sie unter /delete.

$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 finden Sie unter /delete/accepted.

$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 finden Sie unter /delete/rejected.

$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 finden Sie in MQTT-Topics für Shadow.

$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 finden Sie unter /get/accepted.

$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 finden Sie unter /get/rejected.

$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 finden Sie unter /update.

$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 finden Sie unter /update/accepted.

$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 finden Sie unter /update/rejected.

$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 finden Sie unter /update/delta.

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

Subscribe

AWS IoT veröffentlicht ein Statusdokument in diesem Topic, wenn das Schattengerät erfolgreich aktualisiert wurde. Weitere Informationen finden Sie unter /update/documents.

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 finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Subscribe

Geräte abonnieren dieses Topic, um Antworten von einer GetPendingJobExecutions-Anforderung zu empfangen. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine GetPendingJobExecutions-Anforderung zu empfangen. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Veröffentlichen

Geräte veröffentlichen eine Nachricht in diesem Topic, um eine StartNextPendingJobExecution-Anforderung auszugeben. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine StartNextPendingJobExecution-Anforderung zu empfangen. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

$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 finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Veröffentlichen

Geräte veröffentlichen eine Nachricht in diesem Topic, um eine DescribeJobExecution-Anforderung auszugeben. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine DescribeJobExecution-Anforderung zu empfangen. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine DescribeJobExecution-Anforderung zu empfangen. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Veröffentlichen

Geräte veröffentlichen eine Nachricht in diesem Topic, um eine UpdateJobExecution-Anforderung auszugeben. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine UpdateJobExecution-Anforderung zu empfangen. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

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

Subscribe

Geräte abonnieren dieses Topic, um Antworten an eine UpdateJobExecution-Anforderung zu empfangen. Weitere Informationen finden Sie unter Verwendung der AWS IoT Jobs-APIs.

$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 finden Sie unter Verwendung der AWS IoT Jobs-APIs.

$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 finden Sie unter Verwendung der AWS IoT Jobs-APIs.

$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: