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 eventi per AWS IoT](iot-events.md#iot-events-enable).
**Topics**
+ [Eventi oggetto](#registry-events-thing)
+ [Eventi di tipo di oggetto](#registry-events-thingtype)
+ [Eventi del gruppo di oggetti](#registry-events-thinggroup)
## 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\$1EVENT".
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
+ AGGIORNATO
+ 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
**Topics**
+ [Tipo di cosa Created/Updated/Deprecated/Undeprecated/Deleted](#registry-events-thingtype-crud)
+ [Tipo di oggetto associato o dissociato rispetto a un oggetto](#registry-events-thingtype-assoc)
### 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\$1TYPE\$1EVENT".
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
+ AGGIORNATO
+ 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](https://docs.aws.amazon.com//iot/latest/developerguide/thing-types-propagating-attributes.html).
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\$1TYPE\$1ASSOCIATION\$1EVENT".
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
**Topics**
+ [Thing Group Created/Updated/Deleted](#registry-events-thinggroup-crud)
+ [Oggetto aggiunto o rimosso in un gruppo di oggetti](#registry-events-thinggroup-addremove)
+ [Gruppo di oggetti aggiunto o rimosso in un gruppo di oggetti](#registry-events-thinggroup-adddelete)
### 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\$1GROUP\$1EVENT".
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
+ AGGIORNATO
+ 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\$1GROUP\$1MEMBERSHIP\$1EVENT".
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\$1GROUP\$1HIERARCHY\$1EVENT".
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.