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.
Registry-Ereignisse
Die Registry kann Ereignismeldungen veröffentlichen, wenn Objekte, Objekttypen und Objektgruppen erstellt, aktualisiert oder gelöscht werden. Diese Ereignisse sind jedoch standardmäßig nicht verfügbar. Weitere Informationen darüber, wie Sie diese Ereignisse aktivieren, finden Sie unter Ereignisse aktivieren für AWS IoT.
Die Registry kann die folgenden Ereignistypen bereitstellen:
Objektereignisse
Objekt erstellt/aktualisiert/gelöscht
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn Objekte erstellt, aktualisiert oder gelöscht werden:
-
$aws/events/thing/
thingName
/created -
$aws/events/thing/
thingName
/updated -
$aws/events/thing/
thingName
/deleted
Die Meldungen enthalten die folgende Beispielnutzlast:
{ "eventType" : "THING_EVENT", "eventId" : "f5ae9b94-8b8e-4d8e-8c8f-b3266dd89853", "timestamp" : 1234567890123, "operation" : "CREATED|UPDATED|DELETED", "accountId" : "123456789012", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "thingName" : "MyThing", "versionNumber" : 1, "thingTypeName" : null, "attributes": { "attribute3": "value3", "attribute1": "value1", "attribute2": "value2" } }
Die Nutzlasten enthalten die folgenden Attribute:
- eventType
-
Auf „THING_EVENT“ festgelegt.
- eventId
-
Eine eindeutige Ereignis-ID (Zeichenfolge).
- timestamp
-
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
- operation
-
Die Operation, die das Ereignis ausgelöst hat. Gültige Werte für sind:
-
CREATED
-
UPDATED
-
GELÖSCHT
-
- accountId
-
Deine AWS-Konto ID.
- thingId
-
Die ID des gerade erstellten, aktualisierten oder gelöschten Objekts.
- thingName
-
Der Name des gerade erstellten, aktualisierten oder gelöschten Objekts.
- versionNumber
-
Die Version des gerade erstellten, aktualisierten oder gelöschten Objekts. Dieser Wert wird bei der Erstellung eines Objekts auf 1 festgelegt. Er wird bei jeder Aktualisierung des Objekts um 1 erhöht.
- Sache TypeName
-
Der mit dem Objekt verknüpfte Objekttyp, sofern vorhanden. Andernfalls
null
. - Attribute
-
Eine Reihe von mit dem Objekt verknüpften Name-Wert-Paaren.
Objekttypereignisse
Ereignisse im Zusammenhang mit dem Objekttyp:
Objekttyp erstellt/als veraltet eingestuft/nicht mehr als veraltet eingestuft/gelöscht
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn Objekttypen erstellt, als veraltet eingestuft, nicht mehr als veraltet eingestuft oder gelöscht werden:
-
$aws/events/thingType/
thingTypeName
/created -
$aws/events/thingType/
thingTypeName
/updated -
$aws/events/thingType/
thingTypeName
/deleted
Die Nachricht enthält die folgende Beispielnutzlast:
{ "eventType" : "THING_TYPE_EVENT", "eventId" : "8827376c-4b05-49a3-9b3b-733729df7ed5", "timestamp" : 1234567890123, "operation" : "CREATED|UPDATED|DELETED", "accountId" : "123456789012", "thingTypeId" : "c530ae83-32aa-4592-94d3-da29879d1aac", "thingTypeName" : "MyThingType", "isDeprecated" : false|true, "deprecationDate" : null, "searchableAttributes" : [ "attribute1", "attribute2", "attribute3" ], "description" : "My thing type" }
Die Nutzlasten enthalten die folgenden Attribute:
- eventType
-
Auf „THING_TYPE_EVENT“ festgelegt.
- eventId
-
Eine eindeutige Ereignis-ID (Zeichenfolge).
- timestamp
-
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
- operation
-
Die Operation, die das Ereignis ausgelöst hat. Gültige Werte für sind:
-
CREATED
-
UPDATED
-
GELÖSCHT
-
- accountId
-
Dein AWS-Konto Ausweis.
- Sache TypeId
-
Die ID des gerade erstellten, als veraltet eingestuften oder gelöschten Objekttyps.
- Sache TypeName
-
Der Name des gerade erstellten, als veraltet eingestuften oder gelöschten Objekttyps.
- isDeprecated
-
true
, wenn der Objekttyp veraltet ist. Andernfallsfalse
. - deprecationDate
-
Der UNIX-Zeitstempel für den Zeitpunkt, an dem der Objekttyp als veraltet eingestuft wurde.
- searchableAttributes
-
Eine Reihe von mit dem Objekttyp verknüpften Name-Wert-Paaren, die für Suchen verwendet werden können.
- description
-
Eine Beschreibung des Objekttyps.
Objekttyp einem Objekt zugeordnet/nicht zugeordnet
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn ein Objekttyp einem Objekt zugeordnet wird oder die Zuordnung entfernt wird.
-
$aws/events/thingTypeAssociation/thing/
thingName
/thingType/typeName
/added -
$aws/events/thingTypeAssociation/thing/
thingName
/thingType/typeName
/removed
Im Folgenden sehen Sie ein Beispiel für eine added
-Nutzlast. Die Nutzlasten für removed
-Nachrichten sind ähnlich.
{ "eventId" : "87f8e095-531c-47b3-aab5-5171364d138d", "eventType" : "THING_TYPE_ASSOCIATION_EVENT", "operation" : "ADDED", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "thingName": "myThing", "thingTypeName" : "MyThingType", "timestamp" : 1234567890123, }
Die Nutzlasten enthalten die folgenden Attribute:
- eventId
-
Eine eindeutige Ereignis-ID (Zeichenfolge).
- eventType
-
Auf "THING_TYPE_ASSOCIATION_EVENT" gesetzt.
- operation
-
Die Operation, die das Ereignis ausgelöst hat. Gültige Werte für sind:
-
HINZUGEFÜGT
-
ENTFERNT
-
- thingId
-
Die ID des Objekts, dessen Zuordnung geändert wurde.
- thingName
-
Der Name des Objekts, dessen Zuordnung geändert wurde.
- Sache TypeName
-
Der Objekttyp, der dem Objekt zugeordnet oder nicht mehr zugeordnet ist.
- timestamp
-
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
Objektgruppenereignisse
Ereignisse im Zusammenhang mit Objektgruppen:
Objektgruppe: erstellt/aktualisiert/gelöscht
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn eine Objektgruppe erstellt, aktualisiert oder gelöscht wird.
-
$aws/events/thingGroup/
groupName
/created -
$aws/events/thingGroup/
groupName
/updated -
$aws/events/thingGroup/
groupName
/deleted
Im Folgenden sehen Sie ein Beispiel für eine updated
-Nutzlast. Die Nutzlasten für created
- und deleted
-Nachrichten sind ähnlich.
{ "eventType": "THING_GROUP_EVENT", "eventId": "8b9ea8626aeaa1e42100f3f32b975899", "timestamp": 1603995417409, "operation": "UPDATED", "accountId": "571EXAMPLE833", "thingGroupId": "8757eec8-bb37-4cca-a6fa-403b003d139f", "thingGroupName": "Tg_level5", "versionNumber": 3, "parentGroupName": "Tg_level4", "parentGroupId": "5fce366a-7875-4c0e-870b-79d8d1dce119", "description": "New description for Tg_level5", "rootToParentThingGroups": [ { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/TgTopLevel", "groupId": "36aa0482-f80d-4e13-9bff-1c0a75c055f6" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level1", "groupId": "bc1643e1-5a85-4eac-b45a-92509cbe2a77" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level2", "groupId": "0476f3d2-9beb-48bb-ae2c-ea8bd6458158" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level3", "groupId": "1d9d4ffe-a6b0-48d6-9de6-2e54d1eae78f" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level4", "groupId": "5fce366a-7875-4c0e-870b-79d8d1dce119" } ], "attributes": { "attribute1": "value1", "attribute3": "value3", "attribute2": "value2" }, "dynamicGroupMappingId": null }
Die Nutzlasten enthalten die folgenden Attribute:
- eventType
-
Auf „THING_GROUP_EVENT“ festgelegt.
- eventId
-
Eine eindeutige Ereignis-ID (Zeichenfolge).
- timestamp
-
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
- operation
-
Die Operation, die das Ereignis ausgelöst hat. Gültige Werte für sind:
-
CREATED
-
UPDATED
-
GELÖSCHT
-
- accountId
-
Dein AWS-Konto Ausweis.
- Sache GroupId
-
Die ID der gerade erstellten, aktualisierten oder gelöschten Objektgruppe.
- Sache GroupName
-
Der Name der gerade erstellten, aktualisierten oder gelöschten Objektgruppe.
- versionNumber
-
Die Version der Objektgruppe. Dieser Wert wird bei der Erstellung einer Objektgruppe auf 1 festgelegt. Er wird bei jeder Aktualisierung der Objektgruppe um 1 erhöht.
- Elternteil GroupName
-
Der Name der übergeordneten Objektgruppe (sofern vorhanden).
- Elternteil GroupId
-
Die ID der übergeordneten Objektgruppe (sofern vorhanden).
- description
-
Eine Beschreibung der Objektgruppe.
- Wurzel ToParent ThingGroups
-
Ein Array mit Informationen zur übergeordneten Objektgruppe. Es gibt ein Element für jede übergeordnete Objektgruppe. Der erste Eintrag bezieht sich auf die Stamm-Objektgruppe und dies wird fortgesetzt, bis die übergeordnete Objektgruppe erreicht wurde. Jeder Eintrag enthält die Werte
groupArn
undgroupId
der Objektgruppe. - Attribute
-
Eine Reihe von mit der Objektgruppe verknüpften Name-Wert-Paaren.
Objekt, das einer Objektgruppe hinzugefügt/aus dieser entfernt wird
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn ein Objekt einer Objektgruppe hinzugefügt oder aus dieser entfernt wird.
-
$aws/events/thingGroupMembership/thingGroup/
thingGroupName
/thing/thingName
/added -
$aws/events/thingGroupMembership/thingGroup/
thingGroupName
/thing/thingName
/removed
Die Meldungen enthalten die folgende Beispielnutzlast:
{ "eventType" : "THING_GROUP_MEMBERSHIP_EVENT", "eventId" : "d684bd5f-6f6e-48e1-950c-766ac7f02fd1", "timestamp" : 1234567890123, "operation" : "ADDED|REMOVED", "accountId" : "123456789012", "groupArn" : "arn:aws:iot:ap-northeast-2:123456789012:thinggroup/MyChildThingGroup", "groupId" : "06838589-373f-4312-b1f2-53f2192291c4", "thingArn" : "arn:aws:iot:ap-northeast-2:123456789012:thing/MyThing", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "membershipId" : "8505ebf8-4d32-4286-80e9-c23a4a16bbd8" }
Die Nutzlasten enthalten die folgenden Attribute:
- eventType
-
Auf „THING_GROUP_MEMBERSHIP_EVENT“ festgelegt.
- eventId
-
Die Ereignis-ID.
- Zeitstempel
-
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
- operation
-
ADDED
, wenn ein Objekt zu einer Objektgruppe hinzugefügt wird,REMOVED
, wenn ein Objekt aus einer Objektgruppe entfernt wird. - accountId
-
Ihr AWS-Konto Ausweis.
- groupArn
-
Der ARN der Objektgruppe.
- groupId
-
Die ID der Gruppe.
- thingArn
-
Der ARN des Objekts, das der Objektgruppe hinzugefügt bzw. daraus entfernt wurde.
- thingId
-
Die ID des Objekts, das der Objektgruppe hinzugefügt bzw. daraus entfernt wurde.
- membershipId
-
Eine ID, die die Beziehung zwischen dem Objekt und der Objektgruppe angibt. Dieser Wert wird generiert, wenn Sie ein Objekt zu einer Objektgruppe hinzufügen.
Objektgruppe, die einer Objektgruppe hinzugefügt/aus dieser gelöscht wird
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn eine Objektgruppe einer anderen Objektgruppe hinzugefügt oder aus dieser entfernt wird.
-
$aws/events/thingGroupHierarchy/thingGroup/
parentThingGroupName
/childThingGroup/childThingGroupName
/added -
$aws/events/thingGroupHierarchy/thingGroup/
parentThingGroupName
/childThingGroup/childThingGroupName
/removed
Die Nachricht enthält die folgende Beispielnutzlast:
{ "eventType" : "THING_GROUP_HIERARCHY_EVENT", "eventId" : "264192c7-b573-46ef-ab7b-489fcd47da41", "timestamp" : 1234567890123, "operation" : "ADDED|REMOVED", "accountId" : "123456789012", "thingGroupId" : "8f82a106-6b1d-4331-8984-a84db5f6f8cb", "thingGroupName" : "MyRootThingGroup", "childGroupId" : "06838589-373f-4312-b1f2-53f2192291c4", "childGroupName" : "MyChildThingGroup" }
Die Nutzlasten enthalten die folgenden Attribute:
- eventType
-
Auf „THING_GROUP_HIERARCHY_EVENT“ festgelegt.
- eventId
-
Die Ereignis-ID.
- Zeitstempel
-
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
- operation
-
ADDED
, wenn ein Objekt zu einer Objektgruppe hinzugefügt wird,REMOVED
, wenn ein Objekt aus einer Objektgruppe entfernt wird. - accountId
-
Ihr AWS-Konto Ausweis.
- Sache GroupId
-
Die ID der übergeordneten Objektgruppe.
- Sache GroupName
-
Der Name der übergeordneten Objektgruppe.
- Kind GroupId
-
Die ID der untergeordneten Objektgruppe.
- Kind GroupName
-
Der Name der untergeordneten Objektgruppe.