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.

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_EVENT“ setzen.

eventId

Eine eindeutige Ereignis-ID (Zeichenfolge).

Zeitstempel

Der UNIX Zeitstempel, zu dem das Ereignis eingetreten ist.

operation

Die Operation, die das Ereignis ausgelöst hat. Gültige Werte für sind:

• CREATED

• UPDATED

• DELETED

accountId

Ihr 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

Ereignisse im Zusammenhang mit dem Objekttyp:

• Art der Sache Created/Updated/Deprecated/Undeprecated/Deleted

• Objekttyp einem Objekt zugeordnet/nicht zugeordnet

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_ _“ gesetzt. TYPE EVENT

eventId

Eine eindeutige Ereignis-ID (Zeichenfolge).

Zeitstempel

Der UNIX Zeitstempel, zu dem das Ereignis eingetreten ist.

operation

Die Operation, die das Ereignis ausgelöst hat. Gültige Werte für sind:

• CREATED

• UPDATED

• DELETED

accountId

Ihr AWS-Konto Ausweis.

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, zu dem der Dingtyp veraltet war.

searchableAttributes

Eine Reihe von mit dem Objekttyp verknüpften Name-Wert-Paaren, die für Suchen verwendet werden können.

propagatingAttributes

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.

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“ setzen.

operation

Die Operation, die das Ereignis ausgelöst hat. Gültige Werte für sind:

• ADDED

• REMOVED

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.

Zeitstempel

Der UNIX Zeitstempel, zu dem das Ereignis eingetreten ist.

Objektgruppenereignisse

Ereignisse im Zusammenhang mit Objektgruppen:

• Dinggruppe Created/Updated/Deleted

• Objekt, das einer Objektgruppe hinzugefügt/aus dieser entfernt wird

• Objektgruppe, die einer Objektgruppe hinzugefügt/aus dieser gelöscht wird

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_ GROUP _EVENT“ setzen.

eventId

Eine eindeutige Ereignis-ID (Zeichenfolge).

Zeitstempel

Der UNIX Zeitstempel, zu dem das Ereignis eingetreten ist.

operation

Die Operation, die das Ereignis ausgelöst hat. Gültige Werte für sind:

• CREATED

• UPDATED

• DELETED

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_ _ GROUP MEMBERSHIP _EVENT“ setzen.

eventId

Die Ereignis-ID.

Zeitstempel

Der UNIX Zeitstempel für den Zeitpunkt, zu dem das Ereignis eingetreten ist.

operation

ADDED, wenn ein Objekt zu einer Objektgruppe hinzugefügt wird, REMOVED, wenn ein Objekt aus einer Objektgruppe entfernt wird.

accountId

Deine AWS-Konto ID.

groupArn

Der ARN der Dinggruppe.

groupId

Die ID der Gruppe.

thingArn

Das ARN Ding, das der Dinggruppe hinzugefügt oder 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“ gesetzt.

eventId

Die Ereignis-ID.

Zeitstempel

Der UNIX Zeitstempel für den Zeitpunkt, zu dem das Ereignis eingetreten ist.

operation

ADDED, wenn ein Objekt zu einer Objektgruppe hinzugefügt wird, REMOVED, wenn ein Objekt aus einer Objektgruppe entfernt wird.

accountId

Deine AWS-Konto ID.

thingGroupId

Die ID der übergeordneten Objektgruppe.

thingGroupName

Der Name der übergeordneten Objektgruppe.

childGroupId

Die ID der untergeordneten Objektgruppe.

childGroupName

Der Name der untergeordneten Objektgruppe.