Skip navigation links

Package software.amazon.awscdk.services.iot

AWS IoT Construct Library

See: Description

Package software.amazon.awscdk.services.iot Description

AWS IoT Construct Library

AWS IoT Core lets you connect billions of IoT devices and route trillions of messages to AWS services without managing infrastructure.

Installation

Install the module: 

 $ npm i @aws-cdk/aws-iot

Import it into your code: 

 import software.amazon.awscdk.core.*;
 import software.amazon.awscdk.core.*;

TopicRule

Create a topic rule that give your devices the ability to interact with AWS services. You can create a topic rule with an action that invoke the Lambda action as following: 

 Function func = Function.Builder.create(this, "MyFunction")
         .runtime(Runtime.NODEJS_14_X)
         .handler("index.handler")
         .code(Code.fromInline("\n    exports.handler = (event) => {\n      console.log(\"It is test for lambda action of AWS IoT Rule.\", event);\n    };"))
         .build();
 
 TopicRule.Builder.create(this, "TopicRule")
         .topicRuleName("MyTopicRule") // optional
         .description("invokes the lambda function") // optional
         .sql(IotSql.fromStringAsVer20160323("SELECT topic(2) as device_id, timestamp() as timestamp FROM 'device/+/data'"))
         .actions(List.of(new LambdaFunctionAction(func)))
         .build();

Or, you can add an action after constructing the TopicRule instance as following: 

 Function func;
 
 
 TopicRule topicRule = TopicRule.Builder.create(this, "TopicRule")
         .sql(IotSql.fromStringAsVer20160323("SELECT topic(2) as device_id, timestamp() as timestamp FROM 'device/+/data'"))
         .build();
 topicRule.addAction(new LambdaFunctionAction(func));

You can also supply errorAction as following, and the IoT Rule will trigger it if a rule's action is unable to perform: 

 import software.amazon.awscdk.core.*;
 
 
 LogGroup logGroup = new LogGroup(this, "MyLogGroup");
 
 TopicRule.Builder.create(this, "TopicRule")
         .sql(IotSql.fromStringAsVer20160323("SELECT topic(2) as device_id, timestamp() as timestamp FROM 'device/+/data'"))
         .errorAction(new CloudWatchLogsAction(logGroup))
         .build();

If you wanna make the topic rule disable, add property enabled: false as following: 

 TopicRule.Builder.create(this, "TopicRule")
         .sql(IotSql.fromStringAsVer20160323("SELECT topic(2) as device_id, timestamp() as timestamp FROM 'device/+/data'"))
         .enabled(false)
         .build();

See also @aws-cdk/aws-iot-actions for other actions.

Skip navigation links

Copyright © 2022. All rights reserved.