@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.152.0 (2022-04-06)

Features

• cfnspec: cloudformation spec v63.0.0 (#19679) (dba96a9)
• cfnspec: cloudformation spec v65.0.0 (#19745) (796fc64)
• cli: add --build option (#19663) (eb9b8e2), closes #19667
• cli: preview of cdk import (#17666) (4f12209)
• core: throw error when stack name exceeds max length (#19725) (1ffd45e)
• eks: add k8s v1.22 (#19756) (9a518c5)
• opensearch: Add latest Opensearch Version 1.2 (#19749) (a2ac36e)
• add new integration test runner (#19754) (1b4d010)
• eks: alb-controller v2.4.1 (#19653) (1ec08df)
• lambda: add support for ephemeral storage (#19552) (f1d9b6a), closes #19605
• s3: EventBridge bucket notifications (#18614) (d8e602b), closes #18076
• synthetics: new puppeteer 3.5 runtime (#19673) (ce2b91b), closes #19634

Bug Fixes

• aws_applicationautoscaling: Add missing members to PredefinedMetric enum (#18978) (75a6fa7), closes #18969
• cli: apps with many resources scroll resource output offscreen (#19742) (053d22c), closes #19160
• cli: support attributes of DynamoDB Tables for hotswapping (#19620) (2321ece), closes #19421
• cloudwatch: automatic metric math label cannot be suppressed (#17639) (7fa3bf2)
• codedeploy: add name validation for Application, Deployment Group and Deployment Configuration (#19473) (9185042)
• codedeploy: the Service Principal is wrong in isolated regions (#19729) (7e9a43d), closes #19399
• core: Fn.select incorrectly short-circuits complex expressions (#19680) (7f26fad)
• core: detect and resolve stringified number tokens (#19578) (7d9ab2a), closes #19546 #19550
• core: reduce CFN template indent size to save bytes (#19656) (fd63ca3)
• ecs: 'desiredCount' and 'ephemeralStorageGiB' cannot be tokens (#19453) (c852239), closes #16648
• ecs: remove unnecessary error when adding volume to external task definition (#19774) (5446ded), closes #19259
• iam: policies aren't minimized as far as possible (#19764) (876ed8a), closes #19751
• logs: Faulty Resource Policy Generated (#19640) (1fdf122), closes #17544