Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
El registro puede publicar mensajes de eventos cuando se crean, actualizan o eliminan objetos, tipos de objetos y grupos de objetos. Estos eventos, sin embargo, no están disponibles de forma predeterminada. Para obtener información sobre cómo activar estos eventos, consulte Habilita los eventos para AWS IoT.
El registro puede proporcionar los siguientes tipos de eventos:
Eventos de objeto
¿Cosa Created/Updated/Deleted
El registro publica los siguientes mensajes de eventos cuando se crean, actualizan o eliminan objetos:
-
$aws/events/thing/
thingName
/created -
$aws/events/thing/
thingName
/updated -
$aws/events/thing/
thingName
/deleted
Los mensajes contienen la siguiente carga de ejemplo:
{
"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"
}
}
Las cargas contienen los siguientes atributos:
- eventType
-
Establézcalo en "THING_EVENT».
- eventId
-
Un ID de evento exclusivo (cadena).
- marca de tiempo
-
La UNIX marca de tiempo del momento en que ocurrió el evento.
- operación
-
La operación en la que se activó el evento. Los valores válidos son:
-
CREATED
-
UPDATED
-
DELETED
-
- accountId
-
Tu ID. Cuenta de AWS
- thingId
-
El ID de la cosa que se crea, actualiza o elimina.
- thingName
-
El nombre de la cosa que se crea, actualiza o elimina.
- versionNumber
-
La versión de la cosa que se crea, actualiza o elimina. Este valor se establece en 1 cuando se crea un objeto. Aumenta en 1 cada vez que se actualiza el objeto.
- thingTypeName
-
El tipo de objeto asociado al objeto, si existiera. De lo contrario,
null
. - attributes
-
Un conjunto de pares nombre-valor asociados al objeto.
Eventos de tipo de objeto
Eventos relacionados con el tipo de objeto:
Tipo de cosa Created/Updated/Deprecated/Undeprecated/Deleted
El registro publica los siguientes mensajes de eventos cuando se crean, actualizan, dejan de estar en desuso, dejan de estar en desuso o se eliminan tipos de cosas:
-
$aws/events/thingType/
thingTypeName
/created -
$aws/events/thingType/
thingTypeName
/updated -
$aws/events/thingType/
thingTypeName
/deleted
El mensaje contiene la siguiente carga de ejemplo:
{
"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"
}
Las cargas contienen los siguientes atributos:
- eventType
-
Establézcalo en "THING_ _TYPE». EVENT
- eventId
-
Un ID de evento exclusivo (cadena).
- marca de tiempo
-
La UNIX marca de tiempo del momento en que ocurrió el evento.
- operación
-
La operación en la que se activó el evento. Los valores válidos son:
-
CREATED
-
UPDATED
-
DELETED
-
- accountId
-
Tu ID. Cuenta de AWS
- thingTypeId
-
El ID del tipo de cosa que se va a crear, actualizar, dejar de utilizar o eliminar.
- thingTypeName
-
El nombre del tipo de cosa que se va a crear, actualizar, dejar de utilizar o eliminar.
- isDeprecated
-
true
si el tipo de objeto está descartado. De lo contrario,false
. - deprecationDate
-
La UNIX marca de tiempo en la que el tipo de cosa quedó obsoleto.
- searchableAttributes
-
Un conjunto de pares nombre-valor asociados con el tipo de objeto que puede utilizarse para realizar búsquedas.
- propagatingAttributes
-
Una lista de atributos de propagación. Un atributo de propagación puede contener un atributo de cosa, un atributo de conexión y una clave de propiedad de usuario. Para obtener más información, consulte Añadir atributos de propagación para enriquecer los mensajes.
- description
-
Una descripción del tipo de objeto.
Tipo de objeto asociado o desasociado de un objeto
El registro publica los siguientes mensajes de eventos cuando se asocia o desasocia un tipo de objeto a un objeto.
-
$aws/events/thingTypeAssociation/thing/
thingName
/thingType/typeName
/added -
$aws/events/thingTypeAssociation/thing/
thingName
/thingType/typeName
/removed
A continuación, se muestra un ejemplo de carga de added
. Las cargas de los mensajes removed
son similares.
{
"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,
}
Las cargas contienen los siguientes atributos:
- eventId
-
Un ID de evento exclusivo (cadena).
- eventType
-
Configúrelo en "THING_ _ TYPE ASSOCIATION _EVENT».
- operación
-
La operación en la que se activó el evento. Los valores válidos son:
-
ADDED
-
REMOVED
-
- thingId
-
El ID de la cosa cuya asociación de tipo ha cambiado.
- thingName
-
El nombre de la cosa cuya asociación de tipo ha cambiado.
- thingTypeName
-
El tipo de objeto asociado o desasociado de la cosa.
- marca de tiempo
-
La UNIX marca de tiempo del momento en que ocurrió el evento.
Eventos de grupo de objetos
Eventos relacionados con el grupo de objetos:
Grupo de cosas Created/Updated/Deleted
El registro publica los siguientes mensajes de eventos cuando se crea, actualiza o elimina un grupo de objetos.
-
$aws/events/thingGroup/
groupName
/created -
$aws/events/thingGroup/
groupName
/updated -
$aws/events/thingGroup/
groupName
/deleted
A continuación, se muestra un ejemplo de carga de updated
. Las cargas de los mensajes created
y deleted
son similares.
{
"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
}
Las cargas contienen los siguientes atributos:
- eventType
-
Establézcalo en "THINGGROUP_ _EVENT».
- eventId
-
Un ID de evento exclusivo (cadena).
- marca de tiempo
-
La UNIX marca de tiempo del momento en que ocurrió el evento.
- operación
-
La operación en la que se activó el evento. Los valores válidos son:
-
CREATED
-
UPDATED
-
DELETED
-
- accountId
-
Tu ID. Cuenta de AWS
- thingGroupId
-
El ID del grupo de objetos que se crea, actualiza o elimina.
- thingGroupName
-
El nombre del grupo de objetos que se crea, actualiza o elimina.
- versionNumber
-
La versión del grupo de objetos. Este valor se establece en 1 cuando se crea un grupo de objetos. Aumenta en 1 cada vez que se actualiza el grupo de objetos.
- parentGroupName
-
El nombre del grupo principal de objetos, si existe.
- parentGroupId
-
El ID del grupo principal de objetos, si existe.
- description
-
Una descripción del grupo de objetos.
- rootToParentThingGroups
-
Una matriz de información acerca del grupo principal de objetos. Hay un elemento por cada grupo principal de objetos, empezando por el grupo de objetos raíz y continuando hasta el grupo principal. Cada entrada contiene los
groupArn
ygroupId
del grupo de objetos. - attributes
-
Un conjunto de pares nombre-valor asociados al grupo de objetos.
Objeto agregado o eliminado de un grupo de objetos
El registro publica los siguientes mensajes de eventos cuando se agrega un objeto a un grupo de objetos o se elimina de este.
-
$aws/events/thingGroupMembership/thingGroup/
thingGroupName
/thing/thingName
/added -
$aws/events/thingGroupMembership/thingGroup/
thingGroupName
/thing/thingName
/removed
Los mensajes contienen la siguiente carga de ejemplo:
{
"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"
}
Las cargas contienen los siguientes atributos:
- eventType
-
Configúrelo en "THINGGROUP_ MEMBERSHIP _ _EVENT».
- eventId
-
El ID del evento.
- marca de tiempo
-
La UNIX marca de tiempo en la que se produjo el evento.
- operación
-
ADDED
cuando se agrega un objeto a un grupo de objetos.REMOVED
cuando se elimina un objeto de un grupo de objetos. - accountId
-
Tu ID. Cuenta de AWS
- groupArn
-
El ARN del grupo de cosas.
- groupId
-
El ID del grupo.
- thingArn
-
El ARN de la cosa que se agregó o quitó del grupo de cosas.
- thingId
-
El ID de la cosa que se agregó o quitó del grupo de objetos.
- membershipId
-
Un ID que representa la relación entre objeto y el grupo de objetos. Este valor se genera cuando agrega un objeto a un grupo de objetos.
Grupo de objetos agregado o eliminado de un grupo de objetos
El registro publica los siguientes mensajes de eventos cuando se agrega un grupo de objetos a otro grupo de objetos o se elimina de este.
-
$aws/events/thingGroupHierarchy/thingGroup/
parentThingGroupName
/childThingGroup/childThingGroupName
/added -
$aws/events/thingGroupHierarchy/thingGroup/
parentThingGroupName
/childThingGroup/childThingGroupName
/removed
El mensaje contiene la siguiente carga de ejemplo:
{
"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"
}
Las cargas contienen los siguientes atributos:
- eventType
-
Establézcalo en "THINGGROUP_ HIERARCHY _ _EVENT».
- eventId
-
El ID del evento.
- marca de tiempo
-
La UNIX marca de tiempo en la que se produjo el evento.
- operación
-
ADDED
cuando se agrega un objeto a un grupo de objetos.REMOVED
cuando se elimina un objeto de un grupo de objetos. - accountId
-
Tu ID. Cuenta de AWS
- thingGroupId
-
El ID del grupo principal de objetos.
- thingGroupName
-
El nombre del grupo principal de objetos.
- childGroupId
-
El ID del grupo secundario de objetos.
- childGroupName
-
El nombre del grupo secundario de objetos.