Eventi del registro - AWS IoT Core
Eventi oggettoEventi di tipo di oggettoEventi del gruppo di oggetti

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Eventi del registro

Il registro pubblica messaggi di evento quando vengono creati, aggiornati o eliminati oggetti, tipi di oggetto e gruppi di oggetti. Tuttavia, questi eventi non sono disponibili per impostazione predefinita. Per ulteriori informazioni su come configurare tali eventi, consulta Abilita gli eventi per AWS IoT.

Il registro può fornire i seguenti tipi di evento:

Eventi oggetto

Oggetto creato/aggiornato/eliminato

Il registro pubblica i messaggi di evento seguenti quando vengono creati, aggiornati o eliminati oggetti:

  • $aws/events/thing/thingName/created

  • $aws/events/thing/thingName/updated

  • $aws/events/thing/thingName/deleted

I messaggi contengono il payload di esempio seguente:

{
    "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"
    }
}

I payload contengono gli attributi seguenti:

eventType

Imposta su "THING_EVENT".

eventId

ID evento univoco (stringa).

timestamp

Timestamp UNIX del momento in cui si è verificato l'evento.

operation

Operazione che ha attivato l'evento. I valori validi sono:

  • CREATED

  • UPDATED

  • ELIMINATO

accountId

Il tuo Account AWS ID.

thingId

ID dell'oggetto creato, aggiornato o eliminato.

thingName

Nome dell'oggetto creato, aggiornato o eliminato.

versionNumber

Versione dell'oggetto creato, aggiornato o eliminato. Questo valore è impostato su 1 quando viene creato un oggetto. Il valore viene incrementato di 1 ogni volta che l'oggetto viene aggiornato.

cosa TypeName

Tipo di oggetto associato all'oggetto, se ne esiste uno. In caso contrario, null.

attributes

Raccolta di coppie nome/valore associate all'oggetto.

Eventi di tipo di oggetto

Tipo di oggetto che è stato creato, dichiarato obsoleto/non più obsoleto o eliminato

Il registro pubblica i messaggi di evento seguenti quando vengono creati, aggiornati, dichiarati obsoleti/non più obsoleti o eliminati tipi di oggetto:

  • $aws/events/thingType/thingTypeName/created

  • $aws/events/thingType/thingTypeName/updated

  • $aws/events/thingType/thingTypeName/deleted

Il messaggio contiene il seguente payload di esempio:

{
    "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"
}

I payload contengono gli attributi seguenti:

eventType

Imposta su "THING_TYPE_EVENT".

eventId

ID evento univoco (stringa).

timestamp

Timestamp UNIX del momento in cui si è verificato l'evento.

operation

Operazione che ha attivato l'evento. I valori validi sono:

  • CREATED

  • UPDATED

  • ELIMINATO

accountId

Il tuo Account AWS ID.

cosa TypeId

ID del tipo di oggetto creato, dichiarato obsoleto o eliminato.

cosa TypeName

Nome del tipo di oggetto creato, dichiarato obsoleto o eliminato.

isDeprecated

true se il tipo di oggetto è obsoleto. In caso contrario, false.

deprecationDate

Timestamp UNIX del momento in cui il tipo di oggetto è stato dichiarato obsoleto.

searchableAttributes

Raccolta di coppie nome/valore associate al tipo di oggetto che può essere usato per la ricerca.

description

Descrizione del tipo di oggetto.

Tipo di oggetto associato o dissociato rispetto a un oggetto

Il registro pubblica i messaggi di evento seguenti quando un tipo di oggetto viene associato o dissociato rispetto a un oggetto.

  • $aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/added

  • $aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/removed

Di seguito è riportato un esempio di added payload. I messaggi di payload per removed sono simili.

{
    "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,
}

I payload contengono gli attributi seguenti:

eventId

ID evento univoco (stringa).

eventType

Imposta su "THING_TYPE_ASSOCIATION_EVENT".

operation

Operazione che ha attivato l'evento. I valori validi sono:

  • AGGIUNTO

  • REMOVED

thingId

L'ID dell'oggetto la cui associazione a un determinato tipo è stata modificata.

thingName

Il nome dell'oggetto la cui associazione a un determinato tipo è stata modificata.

cosa TypeName

Il tipo di oggetto associato, o non più associato, con l'oggetto.

timestamp

Timestamp UNIX del momento in cui si è verificato l'evento.

Eventi del gruppo di oggetti

Gruppo di oggetti creato/aggiornato/eliminato

Il registro pubblica i messaggi di evento seguenti quando viene creato, aggiornato o eliminato un gruppo di oggetti.

  • $aws/events/thingGroup/groupName/created

  • $aws/events/thingGroup/groupName/updated

  • $aws/events/thingGroup/groupName/deleted

Di seguito è riportato un esempio di updated payload. I messaggi di payload per created e deleted sono simili.

{
  "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
}

I payload contengono gli attributi seguenti:

eventType

Imposta su "THING_GROUP_EVENT".

eventId

ID evento univoco (stringa).

timestamp

Timestamp UNIX del momento in cui si è verificato l'evento.

operation

Operazione che ha attivato l'evento. I valori validi sono:

  • CREATED

  • UPDATED

  • ELIMINATO

accountId

Il tuo Account AWS ID.

cosa GroupId

ID del gruppo di oggetti creato, aggiornato o eliminato.

cosa GroupName

Nome del gruppo di oggetti creato, aggiornato o eliminato.

versionNumber

Versione del gruppo di oggetti. Questo valore è impostato su 1 quando viene creato un gruppo di oggetti. Il valore viene incrementato di 1 ogni volta che il gruppo di oggetti viene aggiornato.

genitore GroupName

Nome del gruppo di oggetti padre, se esistente.

genitore GroupId

ID del gruppo di oggetti padre, se esistente.

description

Descrizione del gruppo di oggetti.

radice ToParent ThingGroups

Matrice di informazioni sul gruppo di oggetti padre. È presente un elemento per ogni gruppo di oggetti padre, iniziando dal gruppo di oggetti root e continuando fino a raggiungere il gruppo di oggetti padre. Ogni voce contiene groupArn e groupId del gruppo di oggetti.

attributes

Raccolta di coppie nome/valore associate al gruppo di oggetti.

Oggetto aggiunto o rimosso in un gruppo di oggetti

Il registro pubblica i messaggi di evento seguenti quando un oggetto viene aggiunto o rimosso in un gruppo di oggetti.

  • $aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added

  • $aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed

I messaggi contengono il payload di esempio seguente:

{
    "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"
}

I payload contengono gli attributi seguenti:

eventType

Imposta su "THING_GROUP_MEMBERSHIP_EVENT".

eventId

ID evento.

timestamp

Timestamp UNIX del momento in cui si è verificato l'evento.

operation

ADDED quando un oggetto viene aggiunto a un gruppo di oggetti. REMOVED quando un oggetto viene rimosso da un gruppo di oggetti.

accountId

Il tuo Account AWS ID.

groupArn

ARN del gruppo di oggetti.

groupId

ID del gruppo.

thingArn

ARN dell'oggetto aggiunto o rimosso nel gruppo di oggetti.

thingId

ID dell'oggetto aggiunto o rimosso nel gruppo di oggetti.

membershipId

ID che rappresenta la relazione tra l'oggetto e il gruppo di oggetti. Questo valore viene generato quando aggiungi un oggetto a un gruppo di oggetti.

Gruppo di oggetti aggiunto o rimosso in un gruppo di oggetti

Il registro pubblica i messaggi di evento seguenti quando un gruppo di oggetti viene aggiunto o rimosso in un altro gruppo di oggetti.

  • $aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added

  • $aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed

Il messaggio contiene il seguente payload di esempio:

{
    "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"
}

I payload contengono gli attributi seguenti:

eventType

Imposta su "THING_GROUP_HIERARCHY_EVENT".

eventId

ID evento.

timestamp

Timestamp UNIX del momento in cui si è verificato l'evento.

operation

ADDED quando un oggetto viene aggiunto a un gruppo di oggetti. REMOVED quando un oggetto viene rimosso da un gruppo di oggetti.

accountId

Il tuo Account AWS documento d'identità.

cosa GroupId

ID del gruppo di oggetti padre.

cosa GroupName

Nome del gruppo di oggetti padre.

bambino GroupId

ID del gruppo di oggetti figlio.

bambino GroupName

Nome del gruppo di oggetti figlio.