@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.149.0 (2022-03-17)

Features

• appsync: add OpenSearch domain data source (#16529) (922a9dc), closes #16528
• assertions: Add the hasNoXXX methods. (#19330) (6bdc9eb), closes #18874
• aws-lambda-nodejs: support additional esbuild configurations (#17788) (ab313a4)
• cfnspec: cloudformation spec v60.0.0 (#19347) (20da648)
• cli: parallel asset publishing (#19367) (c8cafef), closes #19193
• ec2: add support for x2idn and x2iedn instances (#19334) (9699efc)
• elbv2: add name validation for target group and load balancer names (#19385) (97e0973), closes /docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-targetgroup.html#cfn-elasticloadbalancingv2 /docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-loadbalancer.html#cfn-elasticloadbalancingv2
• iotevents: support SetVariable action (#19305) (c222b12)
• lambda: dotnet6 runtime (#19144) (bbed27d)
• synthetics: add vpc configuration (#18447) (c991e92), closes #11865 #9954

Bug Fixes

• cli: failure to load malformed YAML is swallowed (#19338) (1875c28), closes #19335
• lambda-event-sources: increase batch size restriction (#19317) (1bc5144), closes #19285
• lambda-nodejs: cannot use esbuildArgs with older esbuild versions (#19343) (59a4d81)
• stepfunctions-tasks: migrate from deprecated batch properties (#19298) (75f5b3b), closes #18993