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à.
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.
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
-
Impostato su "THING_EVENT».
- eventId
-
ID evento univoco (stringa).
- timestamp
-
Il UNIX timestamp di quando si è verificato l'evento.
- operation
-
Operazione che ha attivato l'evento. I valori validi sono:
-
CREATED
-
UPDATED
-
DELETED
-
- accountId
-
Il tuo ID. Account AWS
- 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
Eventi correlati al 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
-
THINGTYPEEVENTImpostato su "_ _».
- eventId
-
ID evento univoco (stringa).
- timestamp
-
Il UNIX timestamp di quando si è verificato l'evento.
- operation
-
Operazione che ha attivato l'evento. I valori validi sono:
-
CREATED
-
UPDATED
-
DELETED
-
- accountId
-
Il tuo ID. Account AWS
- 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
-
Il UNIX timestamp relativo al 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.
- propagatingAttributes
-
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
-
Impostato su "THING_ _ TYPE ASSOCIATION _EVENT».
- operation
-
Operazione che ha attivato l'evento. I valori validi sono:
-
ADDED
-
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
-
Il UNIX timestamp di quando si è verificato l'evento.
Eventi del gruppo di oggetti
Eventi correlati al gruppo di oggetti:
Gruppo di cose 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
-
Impostato su "THING_ GROUP _EVENT».
- eventId
-
ID evento univoco (stringa).
- timestamp
-
Il UNIX timestamp di quando si è verificato l'evento.
- operation
-
Operazione che ha attivato l'evento. I valori validi sono:
-
CREATED
-
UPDATED
-
DELETED
-
- accountId
-
Il tuo ID. Account AWS
- 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
egroupId
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
-
Impostato su "THING_ GROUP _ MEMBERSHIP _EVENT».
- eventId
-
ID evento.
- timestamp
-
Il UNIX timestamp di quando 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 ID. Account AWS
- groupArn
-
Il gruppo ARN delle cose.
- groupId
-
ID del gruppo.
- thingArn
-
L'ARNelemento che è stato aggiunto o rimosso dal 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
-
Impostato su "THING_ GROUP _ HIERARCHY _EVENT».
- eventId
-
ID evento.
- timestamp
-
Il UNIX timestamp di quando 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 ID. Account AWS
- 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.