@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 s3n from '@aws-cdk/aws-s3-notifications';

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

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

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

import * as s3n from '@aws-cdk/aws-s3-notifications';

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

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

Changelog

1.136.0 (2021-12-15)

⚠ BREAKING CHANGES TO EXPERIMENTAL FEATURES

• appsync: The CachingConfig#ttl property is now required.

• glue: the grantRead API previously included 'glue:BatchDeletePartition', and now it does not.

Features

• amplify: Add Amplify asset deployment resource (#16922) (499ba85), closes #16208
• apigateway: add option to set the base path when adding a domain name to a Rest API (#17915) (9af5b4d)
• apigatewayv2: Lambda authorizer for WebSocket API (#16886) (67cce37), closes #13869
• aws-applicationautoscaling: Allow autoscaling with "M out of N" datapoints (#17441) (c21320d), closes #17433
• aws-applicationautoscaling: enabling autoscaling for ElastiCache Redis cluster (#17919) (7f54ed6)
• aws-ecs: expose environment from containerDefinition (#17889) (4937cd0), closes #17867
• aws-s3: add support for BucketOwnerEnforced to S3 ObjectOwnershipType (#17961) (93fafc5), closes #17926
• cfnspec: cloudformation spec v51.0.0 (#17955) (c6b7a49), closes #17943
• cli: Hotswapping Support for S3 Bucket Deployments (#17638) (1df478b)
• codecommit: allow initializing a Repository with contents (#17968) (54b6cc6), closes #17967 #16958
• ec2: add d3 and d3en instances (#17782) (8b52196), closes /docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2
• ec2: add high memory instances u-6tb1, u-9tb1, u-12tb1, u-18tb1, and u-24tb1 (#17964) (5497525)
• ec2: add im4gn and is4gen instances (#17780) (e057c8f), closes /docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2
• iotevents: add IoT Events input L2 Construct (#17847) (9f03dc4), closes /github.com/aws/aws-cdk/issues/17711#issuecomment-986153267
• lambda: add cloudwatch lambda insights arm support (#17665) (02749b4), closes #17133

Bug Fixes

• appmesh: adding support with gateway route priority (#17694) (a61576f), closes #16821
• appsync: ttl property of CachingConfig is not required (#17981) (73e5fec)
• aws-autoscaling: notificationTargetArn should be optional in LifecycleHook (#16187) (4e7a275), closes #14641
• aws-lambda-nodejs: use closest lockfile when autodetecting (#16629) (c4ecd96), closes #15847 40aws-cdk/aws-lambda-nodejs/lib/function.ts#L137-L139 /github.com/aws/aws-cdk/issues/15847#issuecomment-903830384
• cli: asset publishing broken cross account (#18007) (2fc6895), closes #17668 #17988
• cli: hotswapping StateMachines with a name fails (#17892) (de67aae), closes #17716
• custom-resources: assumedRole from AwsCustomResource invocation leaked to next execution (#15776) (e138188), closes #15425
• glue: remove batchDeletePartition from grantRead() permissions (#17941) (3d64f9b), closes #17935 #15116
• logs: log retention fails with OperationAbortedException (#17688) (95b8da9), closes #17546
• rds: unable to use tokens as port in DatabaseInstance (#17995) (0745193), closes #17948