Registry-Ereignisse - AWS IoT Core
ObjektereignisseObjekttypereignisseObjektgruppenereignisse

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

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

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

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