@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.138.0 (2022-01-04)

⚠ BREAKING CHANGES TO EXPERIMENTAL FEATURES

• lambda-python: assetHashType and assetHash properties moved to new bundling property.
• lambda-python: Runtime is now required for LambdaPython

Features

• apigateway: Add stage ARN attribute (#18170) (be7acfd)
• aws-autoscaling: Add support for termination policies (#17936) (9e6f977), closes #15654
• aws-ec2: add g4ad instance types (#17927) (8cb6a76), closes #17565
• cfnspec: add CloudFormation documentation to L1 classes (#18101) (0ed661d)
• cli: hotswap deployments for CodeBuild projects (#18161) (4ae4df8)
• cli: show how long cdk deploy steps take (#18230) (82fa742), closes #18213
• cli: support for hotswapping Lambda Versions and Aliases (#18145) (13d77b7), closes #18058 #17043
• codepipeline: variables for CodeStar Connections source Action (#18086) (c99da16), closes #17807
• custom-resources: NoEcho for sensitive data in provider framework (#18097) (621a410)
• docdb: allow setting log retention (#18120) (002202f), closes #13191
• ec2: add Windows Server 2022 WindowsVersions (#18203) (dee732d), closes #18199
• glue: support partition index on tables (#17998) (c071367), closes #17589
• iot: Action to send messages to SQS queues (#18087) (37537fe), closes #17699
• iot: add Action to set a CloudWatch alarm (#18021) (de2369c), closes #17705
• lambda-python: support for providing a custom bundling docker image (#18082) (c3c4a97), closes #10298 #12949 #15391 #16234 #15306
• msk: add Kafka versions 2.6.3, 2.7.1 and 2.7.2 (#18191) (8832df1)
• secretsmanager: create secrets with specified values (#18098) (dd90b8e), closes #5810
• ssm: reference latest version of secure string parameters (#18187) (7d0680a), closes #17091

Bug Fixes

• amplify: deploy asset Custom Resource points to TS file (#18166) (a1508af)
• cloudfront-origins: policy not added for custom OAI (#18192) (c894ba1), closes #18185
• core: Duration.toString() throws an error (#18243) (df03df8), closes #18176
• core: overriding of Stack.addFileAsset() no longer has effect (#18116) (2290681), closes #17328
• events: event bus name only generated if no props passed (#18153) (9b81662), closes #18070
• lambda-python: runtime is now required (#18143) (98f1bb1), closes #10248
• region-info: ssm service principal - fix more regions (#18135) (ed30c44), closes #16188

Reverts

• cfnspec: add CloudFormation documentation to L1 classes (#18177) (2530016)