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

Cosa Created/Updated/Deleted

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

La tua Account AWS carta d'identità.

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.

thingTypeName

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 cosa Created/Updated/Deprecated/Undeprecated/Deleted

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

  • $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" ],
    "propagatingAttributes": [
        {
	    "userPropertyKey": "key",
	    "thingAttribute": "model"
        },
        {
	    "userPropertyKey": "key",
	    "connectionAttribute": "iot:ClientId"
        }
    ],
    "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

Account AWS Il tuo ID.

thingTypeId

L'ID del tipo di oggetto che viene creato, aggiornato, obsoleto o eliminato.

thingTypeName

Il nome del tipo di oggetto che viene creato, aggiornato, 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.

Attributi di propagazione

Un elenco di attributi di propagazione. Un attributo di propagazione può contenere un attributo thing, un attributo connection e una chiave di proprietà utente. Per ulteriori informazioni, vedere Aggiungere attributi di propagazione per l'arricchimento dei messaggi.

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.

thingTypeName

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

Thing Group Created/Updated/Deleted

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.

thingGroupId

ID del gruppo di oggetti creato, aggiornato o eliminato.

thingGroupName

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.

parentGroupName

Nome del gruppo di oggetti padre, se esistente.

parentGroupId

ID del gruppo di oggetti padre, se esistente.

description

Descrizione del gruppo di oggetti.

rootToParentThingGroups

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 documento d'identità.

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

thingGroupId

ID del gruppo di oggetti padre.

thingGroupName

Nome del gruppo di oggetti padre.

childGroupId

ID del gruppo di oggetti figlio.

childGroupName

Nome del gruppo di oggetti figlio.