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.
AWS IoT Events trabajando con otros AWS servicios
AWS IoT Events admite las siguientes acciones que le permiten trabajar con AWS los servicios:
-
iotTopicPublishpublicar un mensaje sobre un MQTT tema.
-
iotEvents para enviar datos a AWS IoT Events como valor de entrada.
-
iotSiteWise para enviar datos a una propiedad de recurso en AWS IoT SiteWise.
-
dynamoDB para enviar datos a una tabla de Amazon DynamoDB.
-
dynamoDBv2 para enviar datos a una tabla de Amazon DynamoDB.
-
firehosepara enviar datos a una transmisión de Amazon Data Firehose.
-
lambda para invocar una función de AWS Lambda .
-
sns para enviar datos como notificación de inserción.
-
sqspara enviar datos a una SQS cola de Amazon.
importante
-
Debes elegir la misma AWS región para ambas AWS IoT Events y los AWS servicios con los que quieres trabajar. Para ver una lista completa de las regiones admitidas, consulte Puntos de conexión y cuotas de AWS IoT Events en la Referencia general de Amazon Web Services.
-
Debe usar la misma AWS región al crear otros AWS recursos para las AWS IoT Events acciones. Si cambias de AWS región, es posible que tengas problemas para acceder a los AWS recursos.
De forma predeterminada, AWS IoT Events genera una carga útil estándar JSON para cualquier acción. Esta carga de acción contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo de detector y el evento que desencadenó la acción. Para configurar la carga de acción, puede usar una expresión de contenido. Para obtener más información, consulte Expresiones para filtrar, transformar y procesar datos de eventos y el tipo de datos de carga útil en la AWS IoT Events API Referencia.
AWS IoT Core
- IoT topic publish action
-
La AWS IoT Core acción le permite publicar un MQTT mensaje a través del intermediario de AWS IoT mensajes. Para ver una lista completa de las regiones admitidas, consulte Puntos de conexión y cuotas de AWS IoT Core en la Referencia general de Amazon Web Services.
El agente de AWS IoT mensajes conecta a AWS IoT los clientes mediante el envío de mensajes desde los clientes publicadores a los clientes suscritos. Para obtener más información, consulte Protocolos de comunicación de dispositivos en la Guía para AWS IoT desarrolladores.
- More information (2)
-
Al publicar un MQTT mensaje, debe especificar los siguientes parámetros.
mqttTopic
-
El MQTT tema que recibe el mensaje.
Puede definir el nombre de un MQTT tema de forma dinámica en tiempo de ejecución mediante variables o valores de entrada creados en el modelo de detector.
payload
-
(Opcional) La carga predeterminada contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo detector y el evento que desencadenó la acción. También puede personalizar la carga. Para obtener más información, consulte Carga útil en la AWS IoT Events APIreferencia.
nota
Asegúrese de que la política adjunta a su función de AWS IoT Events servicio conceda el
iot:Publish
permiso. Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte IotTopicPublishActionla AWS IoT Events APIReferencia.
AWS IoT Events
- IoT Events action
-
La AWS IoT Events acción le permite enviar datos a AWS IoT Events como entrada. Para ver una lista completa de las regiones admitidas, consulte Puntos de conexión y cuotas de AWS IoT Events en la Referencia general de Amazon Web Services.
AWS IoT Events le permite monitorizar sus equipos o flotas de dispositivos para detectar fallos o cambios en el funcionamiento y activar acciones cuando se produzcan dichos eventos. Para obtener más información, consulte ¿Qué es? AWS IoT Events en la Guía para AWS IoT Events desarrolladores.
- More information (2)
-
Al enviar datos a AWS IoT Events, debe especificar los siguientes parámetros.
inputName
-
El nombre de la AWS IoT Events entrada que recibe los datos.
payload
-
(Opcional) La carga predeterminada contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo detector y el evento que desencadenó la acción. También puede personalizar la carga. Para obtener más información, consulte Carga útil en la AWS IoT Events APIreferencia.
nota
Asegúrese de que la política adjunta a su función de AWS IoT Events servicio conceda el
iotevents:BatchPutMessage
permiso. Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte IotEventsActionla AWS IoT Events APIReferencia.
AWS IoT SiteWise
- IoT SiteWise action
-
La AWS IoT SiteWise acción le permite enviar datos a una propiedad de un activo en AWS IoT SiteWise. Para ver una lista completa de las regiones admitidas, consulte Puntos de conexión y cuotas de AWS IoT SiteWise en la Referencia general de Amazon Web Services.
AWS IoT SiteWise es un servicio gestionado que le permite recopilar, organizar y analizar datos de equipos industriales a escala. Para obtener más información, consulte ¿Qué es AWS IoT SiteWise? en la Guía del usuario de AWS IoT SiteWise .
- More information (11)
-
Al enviar datos a una propiedad de un activo AWS IoT SiteWise, debe especificar los siguientes parámetros.
importante
Para recibir los datos, debe utilizar una propiedad de activo existente en AWS IoT SiteWise.
-
Si utiliza la AWS IoT Events consola, debe especificar si desea
propertyAlias
identificar la propiedad del activo objetivo. -
Si utiliza la AWS CLI, debe especificar una
propertyAlias
o ambasassetId
epropertyId
identificar la propiedad del activo objetivo.
Para obtener más información, consulte Mapeo de flujos de datos industriales a propiedades de activos en la Guía del usuario de AWS IoT SiteWise .
propertyAlias
-
(Opcional) El alias de la propiedad de activo. También puede especificar una expresión.
assetId
-
(Opcional) El ID del activo que tiene la propiedad especificada. También puede especificar una expresión.
propertyId
-
(Opcional) ID de la propiedad de activo. También puede especificar una expresión.
entryId
-
(Opcional) Un identificador único para esta entrada. Puede utilizar el ID de entrada para realizar un seguimiento de qué entrada de datos provoca un error en caso de que se produzca un fallo. El valor predeterminado es un nuevo identificador único. También puede especificar una expresión.
propertyValue
-
Una estructura que contenga los detalles sobre el valor de propiedad.
quality
-
(Opcional) La calidad del valor de la propiedad de activo. El valor debe ser
GOOD
,BAD
oUNCERTAIN
. También puede especificar una expresión. timestamp
-
(Opcional) Una estructura que contenga la información de marca temporal. Si no especifica este valor, el predeterminado es el momento del evento.
timeInSeconds
-
La marca temporal, en segundos, en formato de tiempo Unix. El rango válido es de 1 a 31556889864403199. También puede especificar una expresión.
offsetInNanos
-
(Opcional) El desplazamiento en nanosegundos convertido de
timeInSeconds
. El rango válido es de 0 a 999999999. También puede especificar una expresión.
value
-
Estructura que contiene un valor de propiedad de activo.
importante
Debe especificar uno de los siguientes tipos de valor, dependiendo del valor
dataType
de la propiedad de activo especificada. Para obtener más información, consulte AssetPropertyla AWS IoT SiteWise APIReferencia.booleanValue
-
(Opcional) El valor de la propiedad de activo es un valor booleano que debe ser
TRUE
oFALSE
. También puede especificar una expresión. Si utiliza una expresión, el resultado evaluado debe ser un valor booleano. doubleValue
-
(Opcional) El valor de la propiedad de activo es un valor doble. También puede especificar una expresión. Si utiliza una expresión, el resultado evaluado debe ser un valor doble.
integerValue
-
(Opcional) El valor de la propiedad de activo es un entero. También puede especificar una expresión. Si utiliza una expresión, el resultado evaluado debe ser un entero.
stringValue
-
(Opcional) El valor de la propiedad de activo es una cadena. También puede especificar una expresión. Si utiliza una expresión, el resultado evaluado debe ser una cadena.
nota
Asegúrese de que la política asociada a su función de AWS IoT Events servicio le conceda el
iotsitewise:BatchPutAssetPropertyValue
permiso. Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte IotSiteWiseActionla AWS IoT Events APIReferencia.
-
Amazon DynamoDB
- DynamoDB action
-
La acción Amazon DynamoDB le permite enviar datos a una tabla de DynamoDB. Una columna de la tabla de DynamoDB recibe todos los pares atributo-valor de la carga de acción que especifique. Para ver una lista de las regiones admitidas, consulte Puntos de conexión y cuotas de Amazon DynamoDB en la Referencia general de Amazon Web Services.
Amazon DynamoDB es un servicio SQL sin base de datos totalmente gestionado que proporciona un rendimiento rápido y predecible con una escalabilidad perfecta. Para obtener más información, consulte ¿Qué es DynamoDB? en la Guía para desarrolladores de Amazon DynamoDB.
- More information (10)
-
Al enviar datos a una columna de una tabla de DynamoDB, debe especificar los siguientes parámetros.
tableName
-
El nombre de la tabla de DynamoDB que recibe los datos. El valor
tableName
debe coincidir con el nombre de tabla de la tabla de DynamoDB. También puede especificar una expresión. hashKeyField
-
El nombre de la clave hash (también denominada clave de partición). El valor
hashKeyField
debe coincidir con la clave de partición de la tabla de DynamoDB. También puede especificar una expresión. hashKeyType
-
(Opcional) El tipo de datos de la clave hash. El valor del tipo de clave hash debe ser
STRING
oNUMBER
. El valor predeterminado esSTRING
. También puede especificar una expresión. hashKeyValue
-
El valor de la clave hash. La
hashKeyValue
utiliza plantillas de sustitución. Estas plantillas proporcionan datos en tiempo de ejecución. También puede especificar una expresión. rangeKeyField
-
(Opcional) El nombre de la clave de rango (también denominada clave de clasificación). El valor
rangeKeyField
debe coincidir con la clave de clasificación de la tabla de DynamoDB. También puede especificar una expresión. rangeKeyType
-
(Opcional) El tipo de datos de la clave de rango. El valor del tipo de clave hash debe ser
STRING
oNUMBER
. El valor predeterminado esSTRING
. También puede especificar una expresión. rangeKeyValue
-
(Opcional) El valor de la clave de rango. La
rangeKeyValue
utiliza plantillas de sustitución. Estas plantillas proporcionan datos en tiempo de ejecución. También puede especificar una expresión. - operación
-
(Opcional) El tipo de operación que se va a realizar. También puede especificar una expresión. El valor de la operación debe ser uno de los siguientes:
-
INSERT
: permite insertar datos como un elemento nuevo en la tabla de DynamoDB. Este es el valor predeterminado. -
UPDATE
: permite actualizar un elemento existente de la tabla de DynamoDB con nuevos datos. -
DELETE
: permite eliminar un elemento existente de la tabla de DynamoDB.
-
payloadField
-
(Opcional) El nombre de la columna de DynamoDB que recibe la carga de acción. El nombre predeterminado es
payload
. También puede especificar una expresión. payload
(Opcional) La carga predeterminada contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo detector y el evento que desencadenó la acción. También puede personalizar la carga. Para obtener más información, consulte Carga útil en la referencia.AWS IoT Events API
Si el tipo de carga útil especificado es una cadena,
DynamoDBAction
envía datos que no sean JSON datos a la tabla de DynamoDB como datos binarios. La consola de DynamoDB mostrará los datos como texto codificado en Base64. El valor depayloadField
es
. También puede especificar una expresión.payload-field
_raw
nota
Asegúrese de que la política asociada a su función de AWS IoT Events servicio conceda el permiso.
dynamodb:PutItem
Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte D ynamoDBAction en la AWS IoT Events APIreferencia.
Amazon DynamoDB(v2)
- DynamoDBv2 action
-
La acción Amazon DynamoDB(v2) le permite escribir datos en una tabla de DynamoDB. Una columna independiente de la tabla de DynamoDB recibe un par atributo-valor de la carga de acción que especifique. Para ver una lista de las regiones admitidas, consulte Puntos de conexión y cuotas de Amazon DynamoDB en la Referencia general de Amazon Web Services.
Amazon DynamoDB es un servicio SQL sin base de datos totalmente gestionado que proporciona un rendimiento rápido y predecible con una escalabilidad perfecta. Para obtener más información, consulte ¿Qué es DynamoDB? en la Guía para desarrolladores de Amazon DynamoDB.
- More information (2)
-
Al enviar datos a varias columnas de una tabla de DynamoDB, debe especificar los siguientes parámetros.
tableName
-
El nombre de la tabla de DynamoDB que recibe los datos. También puede especificar una expresión.
payload
(Opcional) La carga predeterminada contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo detector y el evento que desencadenó la acción. También puede personalizar la carga. Para obtener más información, consulte Carga útil en la referencia.AWS IoT Events API
importante
El tipo de carga útil debe ser. JSON También puede especificar una expresión.
nota
Asegúrese de que la política asociada a su función de AWS IoT Events servicio conceda el
dynamodb:PutItem
permiso. Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte D ynamoDBv 2Action en la AWS IoT Events APIreferencia.
Amazon Data Firehose
- Firehose action
-
La acción Amazon Data Firehose te permite enviar datos a una cadena de entrega de Firehose. Para ver la lista de regiones compatibles, consulte los puntos de enlace y las cuotas de Amazon Data Firehose en. Referencia general de Amazon Web Services
Amazon Data Firehose es un servicio totalmente gestionado para entregar datos de streaming en tiempo real a destinos como Amazon Simple Storage Service (Amazon Simple Storage Service), Amazon Redshift, OpenSearch Amazon OpenSearch Service (Service) y Splunk. Para obtener más información, consulte ¿Qué es Amazon Data Firehose? en la Guía para desarrolladores de Amazon Data Firehose.
- More information (3)
-
Al enviar datos a un flujo de entrega de Firehose, debe especificar los siguientes parámetros.
deliveryStreamName
-
El nombre del flujo de entrega de Firehose que recibe los datos.
separator
-
(Opcional) Puede usar un separador de caracteres para separar los datos continuos enviados al flujo de entrega de Firehose. El valor del separador debe ser
'\n'
(nueva línea),'\t'
(tabulador),'\r\n'
(nueva línea de Windows) o','
(coma). payload
-
(Opcional) La carga predeterminada contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo detector y el evento que desencadenó la acción. También puede personalizar la carga. Para obtener más información, consulte Carga útil en la AWS IoT Events API referencia.
nota
Asegúrese de que la política adjunta a su función de AWS IoT Events servicio conceda el
firehose:PutRecord
permiso. Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte FirehoseActionla AWS IoT Events APIReferencia.
AWS Lambda
- Lambda action
-
La AWS Lambda acción permite llamar a una función Lambda. Para ver una lista completa de las regiones admitidas, consulte Puntos de conexión y cuotas de AWS Lambda en la Referencia general de Amazon Web Services.
AWS Lambda es un servicio informático que permite ejecutar código sin aprovisionar ni administrar servidores. Para obtener más información, consulta ¿Qué es? AWS Lambda en la Guía para AWS Lambda desarrolladores.
- More information (2)
-
Al llamar a una función de Lambda, debe especificar los siguientes parámetros.
functionArn
-
La ARN de la función Lambda a llamar.
payload
-
(Opcional) La carga predeterminada contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo detector y el evento que desencadenó la acción. También puede personalizar la carga. Para obtener más información, consulte Carga útil en la AWS IoT Events API referencia.
nota
Asegúrese de que la política adjunta a su función de AWS IoT Events servicio conceda el
lambda:InvokeFunction
permiso. Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte LambdaActionla AWS IoT Events APIReferencia.
Amazon Simple Notification Service
- SNS action
-
La acción de publicación de SNS temas de Amazon te permite publicar un SNS mensaje de Amazon. Para obtener la lista de las regiones admitidas, consulte Puntos de conexión y cuotas de Amazon Simple Notification Service en la Referencia general de Amazon Web Services.
Amazon Simple Notification Service (Amazon Simple Notification Service) es un servicio web que coordina y gestiona la entrega o el envío de mensajes a los puntos de conexión o clientes suscritos. Para obtener más información, consulta ¿Qué es AmazonSNS? en la guía para desarrolladores de Amazon Simple Notification Service.
nota
La acción de publicación de SNS temas de Amazon no admite los temas de Amazon SNS FIFO (primero en entrar, primero en salir). Como el motor de reglas es un servicio totalmente distribuido, es posible que los mensajes no se muestren en un orden específico cuando se inicie la SNS acción de Amazon.
- More information (2)
-
Cuando publiques un SNS mensaje de Amazon, debes especificar los siguientes parámetros.
targetArn
-
El ARN del SNS destinatario de Amazon que recibe el mensaje.
payload
-
(Opcional) La carga predeterminada contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo detector y el evento que desencadenó la acción. También puede personalizar la carga. Para obtener más información, consulta Carga útil en la AWS IoT Events APIreferencia.
nota
Asegúrese de que la política adjunta a su función de AWS IoT Events servicio conceda el
sns:Publish
permiso. Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte SNSTopicPublishActionla AWS IoT Events APIReferencia.
Amazon Simple Queue Service
- SQS action
-
La SQS acción Amazon te permite enviar datos a una SQS cola de Amazon. Para obtener una lista de las regiones admitidas, consulte Puntos de conexión y cuotas de Amazon Simple Queue Service en la Referencia general de Amazon Web Services.
Amazon Simple Queue Service (AmazonSQS) ofrece una cola alojada segura, duradera y disponible que le permite integrar y desacoplar sistemas y componentes de software distribuidos. Para obtener más información, consulte Qué es Amazon Simple Queue Service> en la Guía para desarrolladores de Amazon Simple Queue Service.
nota
La SQS acción de Amazon no admite temas de >Amazon SQS FIFO (primero en entrar, primero en salir). Como el motor de reglas es un servicio totalmente distribuido, es posible que los mensajes no se muestren en un orden específico cuando se inicie la SQS acción de Amazon.
- More information (3)
-
Cuando envíes datos a una SQS cola de Amazon, debes especificar los siguientes parámetros.
queueUrl
-
El URL de la SQS cola de Amazon que recibe los datos.
useBase64
-
(Opcional) AWS IoT Events codifica los datos en texto en Base64, si lo especificas.
TRUE
El valor predeterminado esFALSE
. payload
-
(Opcional) La carga predeterminada contiene todos los pares atributo-valor que tienen la información sobre la instancia del modelo detector y el evento que desencadenó la acción. También puede personalizar la carga. Para obtener más información, consulte Carga útil en la referencia.AWS IoT Events API
nota
Asegúrese de que la política adjunta a su función de AWS IoT Events servicio conceda el
sqs:SendMessage
permiso. Para obtener más información, consulte Administración de identidad y acceso para AWS IoT Events.Para obtener más información, consulte SNSTopicPublishActionla AWS IoT Events APIReferencia.
También puedes usar Amazon SNS y el motor de AWS IoT Core reglas para activar una AWS Lambda función. Esto permite realizar acciones mediante otros servicios, como Amazon Connect, o incluso una aplicación de planificación de recursos empresariales (ERP) de la empresa.
nota
Para recopilar y procesar grandes flujos de registros de datos en tiempo real, puede utilizar otros AWS servicios, como Amazon Kinesis. Desde allí, puede completar un análisis inicial y, a continuación, enviar los resultados AWS IoT Events como entrada a un detector.