As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Trabalhando com outros AWS serviços
AWS IoT Events suporta as seguintes ações que permitem trabalhar com AWS serviços:
-
iotTopicPublishpara publicar uma mensagem sobre um MQTT tópico.
-
iotEvents para enviar dados para AWS IoT Events como um valor de entrada.
-
iotSiteWise para enviar dados para uma propriedade de ativo no AWS IoT SiteWise.
-
dynamoDB para enviar dados para uma tabela do Amazon DynamoDB.
-
dynamoDBv2 para enviar dados para uma tabela do Amazon DynamoDB.
-
firehosepara enviar dados para um stream do Amazon Data Firehose.
-
lambda para invocar uma função do AWS Lambda .
-
sns para enviar dados como uma notificação por push.
-
sqspara enviar dados para uma SQS fila da Amazon.
Importante
-
Você deve escolher a mesma AWS região para ambas AWS IoT Events e os AWS serviços com os quais trabalhar. Para obter a lista de regiões compatíveis, consulte Endpoints e cotas do AWS IoT Events no Referência geral da Amazon Web Services.
-
Você deve usar a mesma AWS região ao criar outros AWS recursos para as AWS IoT Events ações. Se você mudar de AWS região, poderá ter problemas para acessar os AWS recursos.
Por padrão, AWS IoT Events gera uma carga padrão JSON para qualquer ação. Essa carga útil da ação contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Para configurar a carga útil da ação, você pode usar uma expressão do conteúdo. Para obter mais informações, consulte Expressões para filtrar, transformar e processar dados de eventos e o tipo de dados de carga útil na AWS IoT Events APIReferência.
AWS IoT Core
- IoT topic publish action
-
A AWS IoT Core ação permite que você publique uma MQTT mensagem por meio do agente de AWS IoT mensagens. Para obter a lista de regiões compatíveis, consulte Endpoints e cotas do AWS IoT Core no Referência geral da Amazon Web Services.
O agente de AWS IoT mensagens conecta AWS IoT clientes enviando mensagens de clientes de publicação para clientes assinantes. Para obter mais informações, consulte Protocolos de comunicação do dispositivo no Guia do AWS IoT desenvolvedor.
- More information (2)
-
Ao publicar uma MQTT mensagem, você deve especificar os seguintes parâmetros.
mqttTopic
-
O MQTT tópico que recebe a mensagem.
Você pode definir um nome de MQTT tópico dinamicamente em tempo de execução usando variáveis ou valores de entrada criados no modelo do detector.
payload
-
(Opcional) A carga útil da ação padrão contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Também é possível personalizar a carga útil. Para obter mais informações, consulte Carga na AWS IoT Events APIReferência.
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
iot:Publish
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte IotTopicPublishActionna AWS IoT Events APIReferência.
AWS IoT Events
- IoT Events action
-
A AWS IoT Events ação permite que você envie dados AWS IoT Events como entrada. Para obter a lista de regiões compatíveis, consulte Endpoints e cotas do AWS IoT Events no Referência geral da Amazon Web Services.
AWS IoT Events permite monitorar suas frotas de equipamentos ou dispositivos em busca de falhas ou alterações na operação e acionar ações quando esses eventos ocorrerem. Para obter mais informações, consulte O que é AWS IoT Events? no Guia do AWS IoT Events desenvolvedor.
- More information (2)
-
Ao enviar dados para AWS IoT Events, você deve especificar os seguintes parâmetros.
inputName
-
O nome da AWS IoT Events entrada que recebe os dados.
payload
-
(Opcional) A carga útil da ação padrão contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Também é possível personalizar a carga útil. Para obter mais informações, consulte Carga na AWS IoT Events APIReferência.
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
iotevents:BatchPutMessage
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte IotEventsActionna AWS IoT Events APIReferência.
AWS IoT SiteWise
- IoT SiteWise action
-
A AWS IoT SiteWise ação permite que você envie dados para uma propriedade do ativo em AWS IoT SiteWise. Para obter a lista de regiões compatíveis, consulte Endpoints e cotas do AWS IoT SiteWise no Referência geral da Amazon Web Services.
AWS IoT SiteWise é um serviço gerenciado que permite coletar, organizar e analisar dados de equipamentos industriais em grande escala. Para obter mais informações, consulte O que é o AWS IoT SiteWise? no Guia do usuário do AWS IoT SiteWise .
- More information (11)
-
Ao enviar dados para uma propriedade do ativo em AWS IoT SiteWise, você deve especificar os seguintes parâmetros.
Importante
Para receber os dados, você deve usar uma propriedade de ativo existente em AWS IoT SiteWise.
-
Se você usar o AWS IoT Events console, deverá especificar
propertyAlias
para identificar a propriedade do ativo de destino. -
Se você usar o AWS CLI, deverá especificar um
propertyAlias
ou ambosassetId
e identificarpropertyId
a propriedade do ativo de destino.
Para obter mais informações, consulte Mapping industrial data streams to asset properties (Mapeamento de fluxos de dados industriais para propriedades de ativos) no Guia do usuário do AWS IoT SiteWise .
propertyAlias
-
(Opcional) O alias da propriedade do ativo. Também é possível especificar uma expressão.
assetId
-
(Opcional) A ID do ativo que tem a propriedade especificada. Também é possível especificar uma expressão.
propertyId
-
(Opcional) A ID de uma propriedade de ativo. Também é possível especificar uma expressão.
entryId
-
(Opcional) Um identificador exclusivo para essa entrada. É possível usar o ID de entrada para rastrear qual entrada de dados causa um erro em caso de falha. O padrão é um novo identificador exclusivo. Também é possível especificar uma expressão.
propertyValue
-
Uma estrutura que contém detalhes sobre o valor da propriedade.
quality
-
(Opcional) A qualidade do valor da propriedade do ativo. O valor deve ser
GOOD
,BAD
ouUNCERTAIN
. Também é possível especificar uma expressão. timestamp
-
(Opcional) Uma estrutura que contém informações do timestamp. Se esse valor não for especificado, o valor padrão será o tempo do evento.
timeInSeconds
-
O time stamp, em segundos, no formato Unix epoch. O intervalo válido é entre 1-31556889864403199. Também é possível especificar uma expressão.
offsetInNanos
-
(Opcional) O deslocamento em nanossegundos convertido de
timeInSeconds
. O intervalo válido é entre 0-999999999. Também é possível especificar uma expressão.
value
-
Uma estrutura que contém um valor de propriedade de ativo.
Importante
É necessário especificar um dos seguintes tipos de valor, dependendo do
dataType
da propriedade de ativo especificada. Para obter mais informações, consulte AssetPropertyna AWS IoT SiteWise APIReferência.booleanValue
-
(Opcional) O valor da propriedade do ativo é um valor booliano que deve ser
TRUE
ouFALSE
. Também é possível especificar uma expressão. Se você usar uma expressão, o resultado avaliado deverá ser um valor booliano. doubleValue
-
(Opcional) O valor da propriedade do ativo é um dobro. Também é possível especificar uma expressão. Se você usar uma expressão, o resultado avaliado deverá ser um dobro.
integerValue
-
(Opcional) O valor da propriedade do ativo é um inteiro. Também é possível especificar uma expressão. Se você usar uma expressão, o resultado avaliado deverá ser um inteiro.
stringValue
-
(Opcional) O valor da propriedade do ativo é uma string. Também é possível especificar uma expressão. Se você usar uma expressão, o resultado avaliado deverá ser uma string.
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
iotsitewise:BatchPutAssetPropertyValue
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte IotSiteWiseActionna AWS IoT Events APIReferência.
-
Amazon DynamoDB
- DynamoDB action
-
A ação do Amazon DynamoDB permite enviar dados para uma tabela do DynamoDB. Uma coluna da tabela do DynamoDB recebe todos os pares de atributo-valor na carga útil que você especifica. Para obter a lista de regiões compatíveis, consulte Amazon DynamoDB endpoints e cotas do no Referência geral da Amazon Web Services.
O Amazon DynamoDB é um serviço SQL sem banco de dados totalmente gerenciado que fornece desempenho rápido e previsível com escalabilidade perfeita. Para obter mais informações, consulte O que é DynamoDB? no Guia do desenvolvedor Amazon DynamoDB.
- More information (10)
-
Ao enviar dados para uma coluna de uma tabela do DynamoDB, você deve especificar os seguintes parâmetros.
tableName
-
O nome da tabela do DynamoDB que recebe os dados. O valor
tableName
deve corresponder ao nome da tabela DynamoDB na tabela. Também é possível especificar uma expressão. hashKeyField
-
O nome da chave de hash (também chamada de chave de partição). O valor
hashKeyField
deve corresponder à chave de partição da tabela DynamoDB. Também é possível especificar uma expressão. hashKeyType
-
(Opcional) O tipo de dados da chave de hash. O valor do tipo de chave de hash deve ser
STRING
ouNUMBER
. O padrão éSTRING
. Também é possível especificar uma expressão. hashKeyValue
-
O valor da chave de hash. O
hashKeyValue
usa modelos de substituição. Esses modelos fornecem dados em runtime. Também é possível especificar uma expressão. rangeKeyField
-
(Opcional) O nome da chave de intervalo (também chamada de chave de classificação). O valor
rangeKeyField
deve corresponder à chave de classificação da tabela do DynamoDB. Também é possível especificar uma expressão. rangeKeyType
-
(Opcional) O tipo de dados da chave de intervalo. O valor do tipo de chave de hash deve ser
STRING
ouNUMBER
. O padrão éSTRING
. Também é possível especificar uma expressão. rangeKeyValue
-
(Opcional) O valor da chave de intervalo. O
rangeKeyValue
usa modelos de substituição. Esses modelos fornecem dados em runtime. Também é possível especificar uma expressão. - operação
-
(Opcional) O tipo de operação a executar. Também é possível especificar uma expressão. O valor da operação deve ser um dos seguintes valores:
-
INSERT
– insira dados como um novo item na tabela do DynamoDB. Este é o valor padrão. -
UPDATE
– atualize um item existente da tabela do DynamoDB com novos dados. -
DELETE
: exclua um item existente da tabela do DynamoDB.
-
payloadField
-
(Opcional) O nome da coluna do DynamoDB que recebe a carga útil da ação. O nome padrão é
payload
. Também é possível especificar uma expressão. payload
-
(Opcional) A carga útil da ação padrão contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Também é possível personalizar a carga útil. Para obter mais informações, consulte Carga na AWS IoT Events APIReferência.
Se o tipo de carga útil especificado for uma string,
DynamoDBAction
enviará JSON dados não- para a tabela do DynamoDB como dados binários. O console do DynamoDB exibe os dados como texto codificado em Base64. O valor depayloadField
é
. Também é possível especificar uma expressão.payload-field
_raw
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
dynamodb:PutItem
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte D ynamoDBAction na AWS IoT Events APIReferência.
Amazon DynamoDB(v2)
- DynamoDBv2 action
-
A ação do Amazon DynamoDB(v2) permite gravar dados em uma tabela do DynamoDB. Uma coluna separada da tabela do DynamoDB recebe um par de atributo-valor na carga útil que você especifica. Para obter a lista de regiões compatíveis, consulte Amazon DynamoDB endpoints e cotas do no Referência geral da Amazon Web Services.
O Amazon DynamoDB é um serviço SQL sem banco de dados totalmente gerenciado que fornece desempenho rápido e previsível com escalabilidade perfeita. Para obter mais informações, consulte O que é DynamoDB? no Guia do desenvolvedor Amazon DynamoDB.
- More information (2)
-
Ao enviar dados para várias colunas de uma tabela do DynamoDB, você deve especificar os parâmetros a seguir.
tableName
-
O nome da tabela do DynamoDB que recebe os dados. Também é possível especificar uma expressão.
payload
-
(Opcional) A carga útil da ação padrão contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Também é possível personalizar a carga útil. Para obter mais informações, consulte Carga na AWS IoT Events APIReferência.
Importante
O tipo de carga útil deve serJSON. Também é possível especificar uma expressão.
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
dynamodb:PutItem
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte D ynamoDBv 2Action na AWS IoT Events APIReferência.
Amazon Data Firehose
- Firehose action
-
A ação Amazon Data Firehose permite que você envie dados para um stream de distribuição do Firehose. Para ver a lista de regiões suportadas, consulte os endpoints e cotas do Amazon Data Firehose no. Referência geral da Amazon Web Services
O Amazon Data Firehose é um serviço totalmente gerenciado para fornecer dados de streaming em tempo real para destinos como Amazon Simple Storage Service (Amazon Simple Storage Service), Amazon Redshift, OpenSearch Amazon OpenSearch Service (Service) e Splunk. Para obter mais informações, consulte O que é o Amazon Data Firehose? no Guia do desenvolvedor do Amazon Data Firehose.
- More information (3)
-
Ao enviar dados para um stream de distribuição do Firehose, você deve especificar os seguintes parâmetros.
deliveryStreamName
-
O nome do stream de entrega do Firehose que recebe os dados.
separator
-
(Opcional) Você pode usar um separador de caracteres para separar dados contínuos enviados para o stream de distribuição do Firehose. O valor do separador deve ser
'\n'
(nova linha),'\t'
(guia),'\r\n'
(nova linha do Windows) ou','
(vírgula). payload
-
(Opcional) A carga útil da ação padrão contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Também é possível personalizar a carga útil. Para obter mais informações, consulte Carga na AWS IoT Events APIReferência.
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
firehose:PutRecord
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte FirehoseActionna AWS IoT Events APIReferência.
AWS Lambda
- Lambda action
-
A AWS Lambda ação permite que você chame uma função Lambda. Para obter a lista de regiões compatíveis, consulte Endpoints e cotas do AWS Lambda no Referência geral da Amazon Web Services.
AWS Lambda é um serviço de computação que permite executar código sem provisionar ou gerenciar servidores. Para obter mais informações, consulte O que é AWS Lambda? no Guia do AWS Lambda desenvolvedor.
- More information (2)
-
Ao chamar uma função do Lambda, você deve especificar os seguintes parâmetros.
functionArn
-
A ARN da função Lambda a ser chamada.
payload
-
(Opcional) A carga útil da ação padrão contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Também é possível personalizar a carga útil. Para obter mais informações, consulte Carga na AWS IoT Events APIReferência.
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
lambda:InvokeFunction
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte LambdaActionna AWS IoT Events APIReferência.
Amazon Simple Notification Service
- SNS action
-
A ação de publicação de SNS tópicos da Amazon permite que você publique uma SNS mensagem da Amazon. Para obter a lista de regiões compatíveis, consulte Amazon Simple Notification Service endpoints e cotas no Referência geral da Amazon Web Services.
O Amazon Simple Notification Service (Amazon Simple Notification Service) é um serviço da Web que coordena e gerencia a entrega ou o envio de mensagens para endpoints ou clientes inscritos. Para obter mais informações, consulte O que é a AmazonSNS? no Guia do desenvolvedor do Amazon Simple Notification Service.
nota
A ação de publicação de SNS tópicos da Amazon não é compatível com tópicos da Amazon SNS FIFO (primeiro a entrar, primeiro a sair). Como o mecanismo de regras é um serviço totalmente distribuído, as mensagens podem não ser exibidas em uma ordem especificada quando a SNS ação da Amazon é iniciada.
- More information (2)
-
Ao publicar uma SNS mensagem da Amazon, você deve especificar os seguintes parâmetros.
targetArn
-
O ARN do SNS alvo da Amazon que recebe a mensagem.
payload
-
(Opcional) A carga útil da ação padrão contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Também é possível personalizar a carga útil. Para obter mais informações, consulte Carga na AWS IoT Events APIReferência.
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
sns:Publish
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte SNSTopicPublishActionna AWS IoT Events APIReferência.
Amazon Simple Queue Service
- SQS action
-
A SQS ação da Amazon permite que você envie dados para uma SQS fila da Amazon. Para obter a lista de regiões compatíveis, consulte Amazon Simple Queue Service endpoints e cotas no Referência geral da Amazon Web Services.
O Amazon Simple Queue Service (AmazonSQS) oferece uma fila hospedada segura, durável e disponível que permite integrar e desacoplar sistemas e componentes de software distribuídos. Para obter mais informações, consulte O que é o Simple Queue Service? no Guia do desenvolvedor do Amazon Simple Queue Service.
nota
A SQS ação da Amazon não oferece suporte a tópicos >Amazon SQS FIFO (primeiro a entrar, primeiro a sair). Como o mecanismo de regras é um serviço totalmente distribuído, as mensagens podem não ser exibidas em uma ordem especificada quando a SQS ação da Amazon é iniciada.
- More information (3)
-
Ao enviar dados para uma SQS fila da Amazon, você deve especificar os seguintes parâmetros.
queueUrl
-
A URL da SQS fila da Amazon que recebe os dados.
useBase64
-
(Opcional) AWS IoT Events codifica os dados em texto Base64, se você especificar.
TRUE
O padrão éFALSE
. payload
-
(Opcional) A carga útil da ação padrão contém todos os pares de atributo-valor que têm as informações sobre a instância do modelo de detector e o evento que acionou a ação. Também é possível personalizar a carga útil. Para obter mais informações, consulte Carga na AWS IoT Events APIReferência.
nota
Certifique-se de que a política anexada à sua função AWS IoT Events de serviço conceda a
sqs:SendMessage
permissão. Para obter mais informações, consulte Gerenciamento de identidade e acesso para AWS IoT Events.Para obter mais informações, consulte SNSTopicPublishActionna AWS IoT Events APIReferência.
Você também pode usar a Amazon SNS e o mecanismo de AWS IoT Core regras para acionar uma AWS Lambda função. Isso possibilita realizar ações usando outros serviços, como o Amazon Connect, ou até mesmo um aplicativo de planejamento de recursos corporativos (ERP) da empresa.
nota
Para coletar e processar grandes fluxos de registros de dados em tempo real, você pode usar outros AWS serviços, como o Amazon Kinesis. A partir daí, você pode concluir uma análise inicial e, em seguida, enviar os resultados AWS IoT Events como entrada para um detector.