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](iot-events.md#iot-events-enable). **Topics** + [Objektereignisse](#registry-events-thing) + [Objekttypereignisse](#registry-events-thingtype) + [Objektgruppenereignisse](#registry-events-thinggroup) ## Objektereignisse **Sache Created/Updated/Deleted** 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\$1EVENT“ 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. Folgende sind gültige Werte: + CREATED + UPDATED + GELÖSCHT accountId Dein AWS-Konto Ausweis. 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. thingTypeName Der mit dem Objekt verknüpfte Objekttyp, sofern vorhanden. Andernfalls `null`. Attribute Eine Reihe von mit dem Objekt verknüpften Name-Wert-Paaren. ## Objekttypereignisse **Topics** + [Art der Sache Created/Updated/Deprecated/Undeprecated/Deleted](#registry-events-thingtype-crud) + [Objekttyp einem Objekt zugeordnet/nicht zugeordnet](#registry-events-thingtype-assoc) ### Art der Sache Created/Updated/Deprecated/Undeprecated/Deleted Die Registrierung veröffentlicht die folgenden Ereignismeldungen, wenn Dingtypen erstellt, aktualisiert, veraltet, nicht mehr unterstützt 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" ], "propagatingAttributes": [ { "userPropertyKey": "key", "thingAttribute": "model" }, { "userPropertyKey": "key", "connectionAttribute": "iot:ClientId" } ], "description" : "My thing type" } ``` Die Nutzlasten enthalten die folgenden Attribute: eventType Auf „THING\$1TYPE\$1EVENT“ 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. Folgende sind gültige Werte: + CREATED + UPDATED + GELÖSCHT accountId Deine ID. AWS-Konto thingTypeId Die ID des Dingtyps, der erstellt, aktualisiert, veraltet oder gelöscht wird. thingTypeName Der Name des Dingtyps, der erstellt, aktualisiert, veraltet oder gelöscht wird. isDeprecated `true`, wenn der Objekttyp veraltet ist. Andernfalls `false`. 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. Attribute propagieren Eine Liste von Attributen, die sich verbreiten. Ein propagierendes Attribut kann ein Dingattribut, ein Verbindungsattribut und einen Benutzereigenschaftsschlüssel enthalten. Weitere Informationen finden Sie unter [Hinzufügen von propagierenden Attributen zur Nachrichtenanreicherung](https://docs.aws.amazon.com//iot/latest/developerguide/thing-types-propagating-attributes.html). 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\$1TYPE\$1ASSOCIATION\$1EVENT" gesetzt. operation Die Operation, die das Ereignis ausgelöst hat. Folgende sind gültige Werte: + HINZUGEFÜGT + ENTFERNT thingId Die ID des Objekts, dessen Zuordnung geändert wurde. thingName Der Name des Objekts, dessen Zuordnung geändert wurde. thingTypeName 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 **Topics** + [Dinggruppe Created/Updated/Deleted](#registry-events-thinggroup-crud) + [Objekt, das einer Objektgruppe hinzugefügt/aus dieser entfernt wird](#registry-events-thinggroup-addremove) + [Objektgruppe, die einer Objektgruppe hinzugefügt/aus dieser gelöscht wird](#registry-events-thinggroup-adddelete) ### Dinggruppe Created/Updated/Deleted 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\$1GROUP\$1EVENT“ 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. Folgende sind gültige Werte: + CREATED + UPDATED + GELÖSCHT accountId Ihr AWS-Konto Ausweis. thingGroupId Die ID der gerade erstellten, aktualisierten oder gelöschten Objektgruppe. thingGroupName 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. parentGroupName Der Name der übergeordneten Objektgruppe (sofern vorhanden). parentGroupId Die ID der übergeordneten Objektgruppe (sofern vorhanden). description Eine Beschreibung der Objektgruppe. rootToParentThingGroups 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` und `groupId` 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\$1GROUP\$1MEMBERSHIP\$1EVENT“ 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\$1GROUP\$1HIERARCHY\$1EVENT“ 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. thingGroupId Die ID der übergeordneten Objektgruppe. thingGroupName Der Name der übergeordneten Objektgruppe. childGroupId Die ID der untergeordneten Objektgruppe. childGroupName Der Name der untergeordneten Objektgruppe.