@aws-cdk/aws-s3-notifications

S3 Bucket Notifications Destinations

---

---

This module includes integration classes for using Topics, Queues or Lambdas as S3 Notification Destinations.

Examples

The following example shows how to send a notification to an SNS topic when an object is created in an S3 bucket:

import * as sns from '@aws-cdk/aws-sns';

const bucket = new s3.Bucket(this, 'Bucket');
const topic = new sns.Topic(this, 'Topic');

bucket.addEventNotification(s3.EventType.OBJECT_CREATED_PUT, new s3n.SnsDestination(topic));

The following example shows how to send a notification to an SQS queue when an object is created in an S3 bucket:

import * as sqs from '@aws-cdk/aws-sqs';

const bucket = new s3.Bucket(this, 'Bucket');
const queue = new sqs.Queue(this, 'Queue');

bucket.addEventNotification(s3.EventType.OBJECT_CREATED_PUT, new s3n.SqsDestination(queue));

The following example shows how to send a notification to a Lambda function when an object is created in an S3 bucket:

import * as lambda from '@aws-cdk/aws-lambda';

const bucket = new s3.Bucket(this, 'Bucket');
const fn = new lambda.Function(this, 'MyFunction', {
  runtime: lambda.Runtime.NODEJS_12_X,
  handler: 'index.handler',
  code: lambda.Code.fromAsset(path.join(__dirname, 'lambda-handler')),
});

bucket.addEventNotification(s3.EventType.OBJECT_CREATED, new s3n.LambdaDestination(fn));

Changelog

1.154.0 (2022-04-27)

Features

• aws-cognito: send emails with a verified domain (#19790) (1d2b1d3), closes #19762
• aws-eks: add annotations and labels to service accounts (#19609) (82aec9d), closes #19607
• cloudwatch: expose dashboardArn for CloudWatch dashboard L2 construct (#20059) (df9814f)
• cloudwatch: expose dashboardName property on the L2 Dashboard construct (#17721) (8cb5dff), closes #17648
• integ-tests: add IntegTest to group test cases (#20015) (b4f8d91)
• integ-tests: make assertions on deployed infrastructure (#20071) (8362efe)
• rds: allow DatabaseClusterFromSnapshot to set copyTagsToSnapshot property (#19932) (40a6ceb), closes #19884
• redshift: expose user.secret as property (#17520) (#20078) (8da006a)
• servicecatalog: graduate to stable 🚀 (#19515) (4764591)

Bug Fixes

• eks: cluster cannot be created in opt-in regions (#20009) (ec06f48), closes #13748 #15579
• eks: remove incomplete support for k8s v1.22 (#20000) (d38a9e4), closes #19756 #19919
• integ-runner: disable-update-workflow default is 'false' instead of false (#20073) (9f7aa65)
• integ-runner: only diff registered stacks (#20100) (721bd4b)
• lambda-python: handler path is incorrectly generated when using PythonFunction (#20083) (6787376)
• tooling: container user's uid does not match host's uid (#20082) (e9670c8), closes #19979
• deploy monitor count is off if there are > 100 changes (#20067) (fd306ee), closes #11805
• imagebuilder: AmiDistributionConfiguration renders empty (#20045) (7bd7139)
• lambda-python: Pipenv projects no longer work for Python 3.6 (#20019) (5024021)
• region-info: EMR service principal incorrect in China (#20014) (84649b8), closes #19867