Amazon IoT rule actions
Amazon IoT rule actions specify what to do when a rule is invoked. You can define actions to send data to an Amazon DynamoDB database, send data to Amazon Kinesis Data Streams, invoke an Amazon Lambda function, and so on. Amazon IoT supports the following actions in Amazon Web Services Regions where the action's service is available.
| Rule action | Description | Name in API |
|---|---|---|
| Apache Kafka | Sends a message to an Apache Kafka cluster. | kafka |
| CloudWatch alarms | Changes the state of an Amazon CloudWatch alarm. | cloudwatchAlarm |
| CloudWatch Logs | Sends a message to Amazon CloudWatch Logs. | cloudwatchLogs |
| CloudWatch metrics | Sends a message to a CloudWatch metric. | cloudwatchMetric |
| DynamoDB | Sends a message to a DynamoDB table. | dynamoDB |
| DynamoDBv2 | Sends message data to multiple columns in a DynamoDB table. | dynamoDBv2 |
| Elasticsearch | Sends a message to an OpenSearch endpoint. | OpenSearch |
| HTTP | Posts a message to an HTTPS endpoint. | http |
| IoT Analytics | Sends a message to an Amazon IoT Analytics channel. | iotAnalytics |
| Amazon IoT Events | Sends a message to an Amazon IoT Events input. | iotEvents |
| Amazon IoT SiteWise | Sends message data to Amazon IoT SiteWise asset properties. | iotSiteWise |
| Firehose | Sends a message to a Firehose delivery stream. | firehose |
| Kinesis Data Streams | Sends a message to a Kinesis data stream. | kinesis |
| Lambda | Invokes a Lambda function with message data as input. | lambda |
| Location | Sends location data to Amazon Location Service. | location |
| OpenSearch | Sends a message to an Amazon OpenSearch Service endpoint. | OpenSearch |
| Republish | Republishes a message to another MQTT topic. | republish |
| S3 | Stores a message in an Amazon Simple Storage Service (Amazon S3) bucket. | s3 |
| Salesforce IoT | Sends a message to a Salesforce IoT input stream. | salesforce |
| SNS | Publishes a message as an Amazon Simple Notification Service (Amazon SNS) push notification. | sns |
| SQS | Sends a message to an Amazon Simple Queue Service (Amazon SQS) queue. | sqs |
| Step Functions | Starts an Amazon Step Functions state machine. | stepFunctions |
| Timestream | Sends a message to an Amazon Timestream database table. | timestream |
Notes
-
Define the rule in the same Amazon Web Services Region as another service's resource so that the rule action can interact with that resource.
-
The Amazon IoT rules engine might make multiple attempts to perform an action if intermittent errors occur. If all attempts fail, the message is discarded and the error is available in your CloudWatch Logs. You can specify an error action for each rule that is invoked after a failure occurs. For more information, see Error handling (error action).
-
Some rule actions activate actions in services that integrate with Amazon Key Management Service (Amazon KMS) to support data encryption at rest. If you use a customer-managed Amazon KMS key (KMS key) to encrypt data at rest, the service must have permission to use the KMS key on the caller's behalf. To learn how to manage permissions for your customer managed KMS key, see the data encryption topics in the appropriate service guide. For more information about customer managed KMS keys, see Amazon Key Management Service concepts in the Amazon Key Management Service Developer Guide.