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.*;
 

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:

 // Example automatically generated from non-compiling source. May contain errors.
 import software.amazon.awscdk.core.*;
 import software.amazon.awscdk.core.*;
 import software.amazon.awscdk.core.*;
 
 
 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:

 // Example automatically generated from non-compiling source. May contain errors.
 Object topicRule = TopicRule.Builder.create(this, "TopicRule")
         .sql(iot.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.*;
 import software.amazon.awscdk.core.*;
 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:

 // Example automatically generated from non-compiling source. May contain errors.
 TopicRule.Builder.create(this, "TopicRule")
         .sql(iot.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.