AWS IoT Core AWS IoT Events AWS IoT SiteWise Amazon DynamoDB Amazon DynamoDB (version 2)Amazon Data Firehose AWS Lambda Amazon Simple Notification Service Amazon Simple Queue Service

AWS IoT Events travailler avec d'autres AWS services

AWS IoT Events prend en charge les actions suivantes qui vous permettent de travailler avec AWS les services :

iotTopicPublishpour publier un message sur un MQTT sujet.
iotEventspour envoyer des données en AWS IoT Events tant que valeur d'entrée.
iotSiteWise pour envoyer des données à une propriété de ressources dans AWS IoT SiteWise.
dynamoDBpour envoyer des données vers une table Amazon DynamoDB.
dynamoDBv2pour envoyer des données vers une table Amazon DynamoDB.
firehosepour envoyer des données vers un flux Amazon Data Firehose.
lambdapour invoquer une AWS Lambda fonction.
snspour envoyer des données sous forme de notification push.
sqspour envoyer des données vers une SQS file d'attente Amazon.

Important

Vous devez choisir la même AWS région pour les deux AWS IoT Events et pour les AWS services avec lesquels vous souhaitez travailler. Pour obtenir la liste des régions prises en charge, consultez Points de terminaison et quotas AWS IoT Events dans le Référence générale d'Amazon Web Services.
Vous devez utiliser la même AWS région lorsque vous créez d'autres AWS ressources pour les AWS IoT Events actions. Si vous changez de AWS région, il se peut que vous rencontriez des problèmes pour accéder aux AWS ressources.

Par défaut, AWS IoT Events génère une charge utile standard JSON pour toute action. Cette charge utile d'action contient toutes les paires attribut-valeur contenant les informations relatives à l'instance du modèle de détecteur et à l'événement qui a déclenché l'action. Pour configurer la charge utile de l'action, vous pouvez utiliser une expression de contenu. Pour plus d'informations, voir Expressions pour filtrer, transformer et traiter les données d'événements et le type de données de charge utile dans la AWS IoT Events APIréférence.

AWS IoT Core

IoT topic publish action

L' AWS IoT Core action vous permet de publier un MQTT message via le courtier de AWS IoT messages. Pour obtenir la liste des régions prises en charge, consultez Points de terminaison et quotas AWS IoT Core dans le Référence générale d'Amazon Web Services.

Le courtier de AWS IoT messages connecte AWS IoT les clients en envoyant des messages des clients éditeurs aux clients abonnés. Pour plus d'informations, consultez la section Protocoles de communication des appareils dans le Guide du AWS IoT développeur.

More information (2)

Lorsque vous publiez un MQTT message, vous devez spécifier les paramètres suivants.

mqttTopic

MQTTRubrique qui reçoit le message.

Vous pouvez définir un nom de MQTT rubrique de manière dynamique lors de l'exécution à l'aide de variables ou de valeurs d'entrée créées dans le modèle de détecteur.

payload

(Facultatif) La charge utile par défaut contient toutes les paires attribut-valeur contenant les informations relatives à l'instance du modèle de détecteur et à l'événement qui a déclenché l'action. Vous pouvez également personnaliser la charge utile. Pour plus d'informations, voir Charge utile dans la AWS IoT Events APIréférence.

Note

Assurez-vous que la politique associée à votre rôle AWS IoT Events de service accorde l'iot:Publishautorisation. Pour de plus amples informations, veuillez consulter Gestion des identités et des accès pour AWS IoT Events.

Pour plus d'informations, reportez-vous IotTopicPublishActionà la section AWS IoT Events APIRéférence.

AWS IoT Events

IoT Events action

L' AWS IoT Events action vous permet d'envoyer des données AWS IoT Events en entrée. Pour obtenir la liste des régions prises en charge, consultez Points de terminaison et quotas AWS IoT Events dans le Référence générale d'Amazon Web Services.

AWS IoT Events vous permet de surveiller votre parc d'équipements ou d'appareils pour détecter les pannes ou les changements de fonctionnement, et de déclencher des actions lorsque de tels événements se produisent. Pour plus d'informations, voir Qu'est-ce que c'est AWS IoT Events ? dans le Guide AWS IoT Events du développeur.

More information (2)

Lorsque vous envoyez des données à AWS IoT Events, vous devez spécifier les paramètres suivants.

inputName: Nom de l' AWS IoT Events entrée qui reçoit les données.
payload: (Facultatif) La charge utile par défaut contient toutes les paires attribut-valeur contenant les informations relatives à l'instance du modèle de détecteur et à l'événement qui a déclenché l'action. Vous pouvez également personnaliser la charge utile. Pour plus d'informations, voir Charge utile dans la AWS IoT Events APIréférence.

Note

Assurez-vous que la politique associée à votre rôle AWS IoT Events de service accorde l'iotevents:BatchPutMessageautorisation. Pour de plus amples informations, veuillez consulter Gestion des identités et des accès pour AWS IoT Events.

Pour plus d'informations, reportez-vous IotEventsActionà la section AWS IoT Events APIRéférence.

AWS IoT SiteWise

IoT SiteWise action

L' AWS IoT SiteWise action vous permet d'envoyer des données à une propriété d'actif dans AWS IoT SiteWise. Pour obtenir la liste des régions prises en charge, consultez Points de terminaison et quotas AWS IoT SiteWise dans le Référence générale d'Amazon Web Services.

AWS IoT SiteWise est un service géré qui vous permet de collecter, d'organiser et d'analyser des données provenant d'équipements industriels à grande échelle. Pour plus d'informations, consultez Présentation d' AWS IoT SiteWise dans le Guide de l'utilisateur AWS IoT SiteWise .

More information (11)

Lorsque vous envoyez des données à une propriété d'actif dans AWS IoT SiteWise, vous devez spécifier les paramètres suivants.

Important

Pour recevoir les données, vous devez utiliser une propriété d'actif existante dans AWS IoT SiteWise.

Si vous utilisez la AWS IoT Events console, vous devez spécifier propertyAlias pour identifier la propriété de l'actif cible.
Si vous utilisez le AWS CLI, vous devez spécifier l'un propertyAlias ou les deux assetId et propertyId identifier la propriété de l'actif cible.

Pour plus d'informations, veuillez consulter la rubrique Mappage de flux de données industrielles avec des propriétés de ressource dans le Guide de l'utilisateur AWS IoT SiteWise .

propertyAlias

(Facultatif) Alias de la propriété de l'actif. Vous pouvez également spécifier une expression.

assetId

(Facultatif) L'ID de l'actif qui possède la propriété spécifiée. Vous pouvez également spécifier une expression.

propertyId

(Facultatif) L'ID de la propriété de l'actif. Vous pouvez également spécifier une expression.

entryId

(Facultatif) Un identifiant unique pour cette entrée. Vous pouvez utiliser l'ID d'entrée pour suivre quelle entrée de données provoque une erreur en cas d'échec. La valeur par défaut est un nouvel identifiant unique. Vous pouvez également spécifier une expression.

propertyValue

Structure contenant des informations sur la valeur de la propriété.

quality

(Facultatif) La qualité de la valeur de la propriété de l'actif. La valeur doit être GOOD, BAD ou UNCERTAIN. Vous pouvez également spécifier une expression.

timestamp

(Facultatif) Structure contenant des informations d'horodatage. Si vous ne spécifiez pas cette valeur, la valeur par défaut est l'heure de l'événement.

timeInSeconds: Horodatage, en secondes, au format époque Unix. La plage valide est comprise entre 1 et 31556889864403199. Vous pouvez également spécifier une expression.
offsetInNanos: (Facultatif) Le décalage en nanosecondes converti à partir detimeInSeconds. La plage valide est comprise entre 0 et 999999999. Vous pouvez également spécifier une expression.

value

Structure contenant une valeur de propriété de ressource.

Important

Vous devez spécifier l'un des types de valeur suivants, en fonction du dataType de la propriété de ressource spécifiée. Pour plus d'informations, reportez-vous AssetPropertyà la section AWS IoT SiteWise APIRéférence.

booleanValue: (Facultatif) La valeur de la propriété de l'actif est une valeur booléenne qui doit être TRUE ou. FALSE Vous pouvez également spécifier une expression. Si vous utilisez une expression, le résultat évalué doit être une valeur booléenne.
doubleValue: (Facultatif) La valeur de la propriété de l'actif est un double. Vous pouvez également spécifier une expression. Si vous utilisez une expression, le résultat évalué doit être un double.
integerValue: (Facultatif) La valeur de la propriété de l'actif est un entier. Vous pouvez également spécifier une expression. Si vous utilisez une expression, le résultat évalué doit être un entier.
stringValue: (Facultatif) La valeur de la propriété de l'actif est une chaîne. Vous pouvez également spécifier une expression. Si vous utilisez une expression, le résultat évalué doit être une chaîne.

Note

Assurez-vous que la politique associée à votre rôle AWS IoT Events de service accorde l'iotsitewise:BatchPutAssetPropertyValueautorisation. Pour de plus amples informations, veuillez consulter Gestion des identités et des accès pour AWS IoT Events.

Pour plus d'informations, reportez-vous IotSiteWiseActionà la section AWS IoT Events APIRéférence.

Amazon DynamoDB

DynamoDB action

L'action Amazon DynamoDB vous permet d'envoyer des données vers une table DynamoDB. Une colonne de la table DynamoDB reçoit toutes les paires attribut-valeur de la charge utile d'action que vous spécifiez. Pour obtenir la liste des régions prises en charge, consultez la section Points de terminaison et quotas Amazon DynamoDB dans le. Référence générale d'Amazon Web Services

Amazon DynamoDB est un service SQL sans base de données entièrement géré qui fournit des performances rapides et prévisibles ainsi qu'une évolutivité sans faille. Pour plus d'informations, voir Qu'est-ce que DynamoDB ? dans le guide du développeur Amazon DynamoDB.

More information (10)

Lorsque vous envoyez des données vers une colonne d'une table DynamoDB, vous devez spécifier les paramètres suivants.

tableName

Nom de la table DynamoDB qui reçoit les données. La tableName valeur doit correspondre au nom de la table DynamoDB. Vous pouvez également spécifier une expression.

hashKeyField

Le nom de la clé de hachage (également appelée clé de partition). La hashKeyField valeur doit correspondre à la clé de partition de la table DynamoDB. Vous pouvez également spécifier une expression.

hashKeyType

(Facultatif) Type de données de la clé de hachage. La valeur du type de clé de hachage doit être STRING ouNUMBER. L’argument par défaut est STRING. Vous pouvez également spécifier une expression.

hashKeyValue

Valeur de la clé de hachage. Il hashKeyValue utilise des modèles de substitution. Ces modèles fournissent des données lors de l'exécution. Vous pouvez également spécifier une expression.

rangeKeyField

(Facultatif) Nom de la clé de plage (également appelée clé de tri). La rangeKeyField valeur doit correspondre à la clé de tri de la table DynamoDB. Vous pouvez également spécifier une expression.

rangeKeyType

(Facultatif) Type de données de la clé de plage. La valeur du type de clé de hachage doit être STRING ouNUMBER. L’argument par défaut est STRING. Vous pouvez également spécifier une expression.

rangeKeyValue

(Facultatif) Valeur de la clé de plage. Il rangeKeyValue utilise des modèles de substitution. Ces modèles fournissent des données lors de l'exécution. Vous pouvez également spécifier une expression.

fonctionnement

(Facultatif) Type d'opération à effectuer. Vous pouvez également spécifier une expression. La valeur de l'opération doit être l'une des valeurs suivantes :

INSERT - Insérer des données en tant que nouvel élément dans la table DynamoDB. C’est la valeur par défaut.
UPDATE - Mettre à jour un élément existant de la table DynamoDB avec de nouvelles données.
DELETE- Supprime un élément existant de la table DynamoDB.

payloadField

(Facultatif) Nom de la colonne DynamoDB qui reçoit la charge utile de l'action. Le nom par défaut est payload. Vous pouvez également spécifier une expression.

payload

Si le type de charge utile spécifié est une chaîne, DynamoDBAction envoie des données autres que JSON des données à la table DynamoDB sous forme de données binaires. La console DynamoDB affiche les données sous la forme de texte codé en Base64. La valeur payloadField est payload-field_raw. Vous pouvez également spécifier une expression.

Note

Assurez-vous que la politique associée à votre rôle AWS IoT Events de service accorde l'dynamodb:PutItemautorisation. Pour de plus amples informations, veuillez consulter Gestion des identités et des accès pour AWS IoT Events.

Pour plus d'informations, voir D ynamoDBAction dans la AWS IoT Events APIréférence.

Amazon DynamoDB (version 2)

DynamoDBv2 action

L'action Amazon DynamoDB (v2) vous permet d'écrire des données dans une table DynamoDB. Une colonne distincte de la table DynamoDB reçoit une paire attribut-valeur dans la charge utile d'action que vous spécifiez. Pour obtenir la liste des régions prises en charge, consultez la section Points de terminaison et quotas Amazon DynamoDB dans le. Référence générale d'Amazon Web Services

More information (2)

Lorsque vous envoyez des données vers plusieurs colonnes d'une table DynamoDB, vous devez spécifier les paramètres suivants.

tableName: Nom de la table DynamoDB qui reçoit les données. Vous pouvez également spécifier une expression.
payload: (Facultatif) La charge utile par défaut contient toutes les paires attribut-valeur contenant les informations relatives à l'instance du modèle de détecteur et à l'événement qui a déclenché l'action. Vous pouvez également personnaliser la charge utile. Pour plus d'informations, voir Charge utile dans la AWS IoT Events APIréférence.

Important
Le type de charge utile doit être. JSON Vous pouvez également spécifier une expression.

Note

Pour plus d'informations, voir D ynamoDBv 2Action dans la AWS IoT Events APIréférence.

Amazon Data Firehose

Firehose action

L'action Amazon Data Firehose vous permet d'envoyer des données vers un flux de diffusion Firehose. Pour obtenir la liste des régions prises en charge, consultez la section Points de terminaison et quotas Amazon Data Firehose dans le. Référence générale d'Amazon Web Services

Amazon Data Firehose est un service entièrement géré qui fournit des données de streaming en temps réel vers des destinations telles qu'Amazon Simple Storage Service (Amazon Simple Storage Service), Amazon Redshift, OpenSearch Amazon OpenSearch Service (Service) et Splunk. Pour plus d'informations, consultez Qu'est-ce qu'Amazon Data Firehose ? dans le manuel Amazon Data Firehose Developer Guide.

More information (3)

Lorsque vous envoyez des données à un flux de diffusion Firehose, vous devez spécifier les paramètres suivants.

deliveryStreamName: Nom du flux de diffusion Firehose qui reçoit les données.
separator: (Facultatif) Vous pouvez utiliser un séparateur de caractères pour séparer les données continues envoyées au flux de diffusion Firehose. La valeur du séparateur doit être '\n' (nouvelle ligne), '\t' (onglet), '\r\n' (nouvelle ligne Windows) ou ',' (virgule).
payload: (Facultatif) La charge utile par défaut contient toutes les paires attribut-valeur contenant les informations relatives à l'instance du modèle de détecteur et à l'événement qui a déclenché l'action. Vous pouvez également personnaliser la charge utile. Pour plus d'informations, voir Charge utile dans la AWS IoT Events APIréférence.

Note

Assurez-vous que la politique associée à votre rôle AWS IoT Events de service accorde l'firehose:PutRecordautorisation. Pour de plus amples informations, veuillez consulter Gestion des identités et des accès pour AWS IoT Events.

Pour plus d'informations, reportez-vous FirehoseActionà la section AWS IoT Events APIRéférence.

AWS Lambda

Amazon Simple Notification Service

SNS action

L'action de publication de SNS sujets Amazon vous permet de publier un SNS message Amazon. Pour obtenir la liste des régions prises en charge, consultez la section Points de terminaison et quotas Amazon Simple Notification Service dans le Référence générale d'Amazon Web Services.

Amazon Simple Notification Service (Amazon Simple Notification Service) est un service Web qui coordonne et gère la livraison ou l'envoi de messages aux points de terminaison ou aux clients abonnés. Pour plus d'informations, consultez Qu'est-ce qu'Amazon SNS ? dans le guide du développeur d'Amazon Simple Notification Service.

Note

L'action de publication de SNS sujets Amazon ne prend pas en charge les sujets Amazon SNS FIFO (premier entré, premier sorti). Le moteur de règles étant un service entièrement distribué, les messages peuvent ne pas s'afficher dans un ordre spécifié lorsque l'SNSaction Amazon est lancée.

More information (2)

Lorsque vous publiez un SNS message Amazon, vous devez spécifier les paramètres suivants.

targetArn: Celui ARN de la SNS cible Amazon qui reçoit le message.
payload: (Facultatif) La charge utile par défaut contient toutes les paires attribut-valeur contenant les informations relatives à l'instance du modèle de détecteur et à l'événement qui a déclenché l'action. Vous pouvez également personnaliser la charge utile. Pour plus d'informations, voir Charge utile dans la AWS IoT Events APIréférence.

Note

Assurez-vous que la politique associée à votre rôle AWS IoT Events de service accorde l'sns:Publishautorisation. Pour de plus amples informations, veuillez consulter Gestion des identités et des accès pour AWS IoT Events.

Pour plus d'informations, reportez-vous SNSTopicPublishActionà la section AWS IoT Events APIRéférence.

Amazon Simple Queue Service

SQS action

L'SQSaction Amazon vous permet d'envoyer des données vers une SQS file d'attente Amazon. Pour obtenir la liste des régions prises en charge, consultez la section Points de terminaison et quotas Amazon Simple Queue Service dans le Référence générale d'Amazon Web Services.

Amazon Simple Queue Service (AmazonSQS) propose une file d'attente hébergée sécurisée, durable et disponible qui vous permet d'intégrer et de dissocier les systèmes et composants logiciels distribués. Pour plus d'informations, consultez What is Amazon Simple Queue Service > dans le guide du développeur Amazon Simple Queue Service.

Note

L'SQSaction Amazon ne prend pas en charge les rubriques >Amazon SQS FIFO (premier entré, premier sorti). Le moteur de règles étant un service entièrement distribué, les messages peuvent ne pas s'afficher dans un ordre spécifié lorsque l'SQSaction Amazon est lancée.

More information (3)

Lorsque vous envoyez des données vers une SQS file d'attente Amazon, vous devez spécifier les paramètres suivants.

queueUrl: Le URL nom de la SQS file d'attente Amazon qui reçoit les données.
useBase64: (Facultatif) AWS IoT Events code les données en texte Base64, si vous le spécifiez. TRUE L’argument par défaut est FALSE.
payload: (Facultatif) La charge utile par défaut contient toutes les paires attribut-valeur contenant les informations relatives à l'instance du modèle de détecteur et à l'événement qui a déclenché l'action. Vous pouvez également personnaliser la charge utile. Pour plus d'informations, voir Charge utile dans la AWS IoT Events APIréférence.

Note

Assurez-vous que la politique associée à votre rôle AWS IoT Events de service accorde l'sqs:SendMessageautorisation. Pour de plus amples informations, veuillez consulter Gestion des identités et des accès pour AWS IoT Events.

Pour plus d'informations, reportez-vous SNSTopicPublishActionà la section AWS IoT Events APIRéférence.

Vous pouvez également utiliser Amazon SNS et le moteur de AWS IoT Core règles pour déclencher une AWS Lambda fonction. Cela permet de prendre des mesures à l'aide d'autres services, tels qu'Amazon Connect, ou même d'une application de planification des ressources d'entreprise (ERP).

Note

Pour collecter et traiter de grands flux d'enregistrements de données en temps réel, vous pouvez utiliser d'autres AWS services, tels qu'Amazon Kinesis. À partir de là, vous pouvez effectuer une analyse initiale, puis envoyer les résultats AWS IoT Events sous forme d'entrée à un détecteur.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Utiliser des actions intégrées

Expressions