CDK Constructs for deploying AWS Events Rule that invokes AWS SNS
Project description
aws-eventbridge-sns module
---Reference Documentation: | https://docs.aws.amazon.com/solutions/latest/constructs/ |
---|
Language | Package |
---|---|
Python | aws_solutions_constructs.aws_eventbridge_sns |
Typescript | @aws-solutions-constructs/aws-eventbridge-sns |
Java | software.amazon.awsconstructs.services.eventbridgesns |
This AWS Solutions Construct implements an AWS Events rule and an AWS SNS Topic.
Here is a minimal deployable pattern definition in Typescript:
import { Duration } from '@aws-cdk/core';
import * as events from '@aws-cdk/aws-events';
import * as iam from '@aws-cdk/aws-iam';
import { EventbridgeToSnsProps, EventbridgeToSns } from "@aws-solutions-constructs/aws-eventbridge-sns";
const props: EventbridgeToSnsProps = {
eventRuleProps: {
schedule: events.Schedule.rate(Duration.minutes(5)),
}
};
const constructStack = new EventbridgeToSns(this, 'test-construct', props);
// Grant yourself permissions to use the Customer Managed KMS Key
const policyStatement = new iam.PolicyStatement({
actions: ["kms:Encrypt", "kms:Decrypt"],
effect: iam.Effect.ALLOW,
principals: [ new iam.AccountRootPrincipal() ],
resources: [ "*" ]
});
constructStack.encryptionKey?.addToResourcePolicy(policyStatement);
Initializer
new EventbridgeToSns(scope: Construct, id: string, props: EventbridgeToSnsProps);
Parameters
- scope
Construct
- id
string
- props
EventbridgeToSnsProps
Pattern Construct Props
Name | Type | Description |
---|---|---|
eventRuleProps | events.RuleProps |
User provided eventRuleProps to override the defaults. |
existingTopicObj? | sns.Topic |
Existing instance of SNS Topic object, providing both this and topicProps will cause an error. |
topicProps? | sns.TopicProps |
User provided props to override the default props for the SNS Topic. |
existingEventBusInterface? | events.IEventBus |
Optional user-provided custom EventBus for construct to use. Providing both this and eventBusProps results an error. |
eventBusProps? | events.EventBusProps |
Optional user-provided properties to override the default properties when creating a custom EventBus. Setting this value to {} will create a custom EventBus using all default properties. If neither this nor existingEventBusInterface is provided the construct will use the default EventBus. Providing both this and existingEventBusInterface results an error. |
enableEncryptionWithCustomerManagedKey? | boolean |
Use a KMS Key, either managed by this CDK app, or imported. If importing an encryption key, it must be specified in the encryptionKey property for this construct. |
encryptionKey? | kms.Key |
An optional, imported encryption key to encrypt the SNS Topic. |
encryptionKeyProps? | kms.KeyProps |
An optional, user provided properties to override the default properties for the KMS encryption key. |
Pattern Properties
Name | Type | Description |
---|---|---|
eventBus? | events.IEventBus |
Returns the instance of events.IEventBus used by the construct |
eventsRule | events.Rule |
Returns an instance of events.Rule created by the construct |
snsTopic | sns.Topic |
Returns an instance of sns.Topic created by the construct |
encryptionKey? | kms.Key |
Returns an instance of kms Key used for the SNS Topic. |
Default settings
Out of the box implementation of the Construct without any override will set the following defaults:
Amazon EventBridge Rule
- Grant least privilege permissions to EventBridge Rule to publish to the SNS Topic.
Amazon SNS Topic
- Configure least privilege access permissions for SNS Topic.
- Enable server-side encryption forSNS Topic using Customer managed KMS Key.
- Enforce encryption of data in transit.
Architecture
© Copyright 2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for aws-solutions-constructs.aws-eventbridge-sns-1.141.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9047e23bc4151efd10f4fdfa5865f28e544b98c4e9b3fdd52084f31be8baa1f8 |
|
MD5 | 7fb7b6e06eeddef8f509e06b853a07df |
|
BLAKE2b-256 | 2a463469bfc67c8528a1ede746556eb84edbb6ee95dc48204d1fa788f49e8b70 |
Close
Hashes for aws_solutions_constructs.aws_eventbridge_sns-1.141.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 27ad899764f7cfe0becf10317a61036d859135db4ba4fcf92f66bb5f24f39238 |
|
MD5 | 1d52bf3fa803c6d622a974bc1bb5ada1 |
|
BLAKE2b-256 | 3e4d6e9acffc9356954ca36c6c21564287e0e5ec379bebc1dadbec03c1f125f5 |