aws-solutions-constructs.aws-events-rule-kinesis-streams 1.115.0

CDK Constructs for deploying Amazon CloudWatch Events Rule that invokes Amazon Kinesis Data Stream

aws-events-rule-kinesisstreams module

---

Some of our early constructs don’t meet the naming standards that evolved for the library. We are releasing completely feature compatible versions with corrected names. The underlying implementation code is the same regardless of whether you deploy the construct using the old or new name. We will support both names for all 1.x releases, but in 2.x we will only publish the correctly named constructs.

All classes are under active development and subject to non-backward compatible changes or removal in any future version. These are not subject to the Semantic Versioning model. This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.

---

Reference Documentation:	https://docs.aws.amazon.com/solutions/latest/constructs/

Language	Package
Python	aws_solutions_constructs.aws_events_rule_kinesisstreams
Typescript	@aws-solutions-constructs/aws-events-rule-kinesisstreams
Java	software.amazon.awsconstructs.services.eventsrulekinesisstreams

This AWS Solutions Construct implements an Amazon CloudWatch Events rule to send data to an Amazon Kinesis data stream.

Here is a minimal deployable pattern definition in Typescript:

# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.core as cdk
from aws_solutions_constructs.aws_events_rule_kinesis_streams import EventsRuleToKinesisStreams, EventsRuleToKinesisStreamsProps

props = EventsRuleToKinesisStreamsProps(
    event_rule_props=RuleProps(
        schedule=events.Schedule.rate(Duration.minutes(5))
    )
)

EventsRuleToKinesisStreams(self, "test-events-rule-kinesis-streams", props)

Initializer

new EventsRuleToKinesisStreams(scope: Construct, id: string, props: EventsRuleToKinesisStreamsProps);

Parameters

• scope Construct
• id string
• props EventsRuleToKinesisStreamsProps

Pattern Construct Props

Name	Type	Description
eventRuleProps	events.RuleProps	User provided eventRuleProps to override the defaults.
existingStreamObj?	kinesis.Stream	Existing instance of Kinesis Stream, providing both this and kinesisStreamProps will cause an error.
kinesisStreamProps?	kinesis.StreamProps	Optional user-provided props to override the default props for the Kinesis stream.
createCloudWatchAlarms	boolean	Whether to create recommended CloudWatch alarms.

Pattern Properties

Name	Type	Description
eventsRule	events.Rule	Returns an instance of events.Rule created by the construct.
kinesisStream	kinesis.Stream	Returns an instance of the Kinesis stream created by the pattern.
eventsRole?	iam.Role	Returns an instance of the iam.Role created by the construct for events rule.

Default settings

Out of the box implementation of the Construct without any override will set the following defaults:

Amazon CloudWatch Events Rule

• Configure least privilege access IAM role for Events Rule to publish to the Kinesis Data Stream.

Amazon Kinesis Stream

• Enable server-side encryption for Kinesis Data Stream using AWS Managed KMS Key.

Architecture

---

© Copyright 2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.