AWS CloudFormation
User Guide (API Version 2010-05-15)

Amazon Simple Email Service ReceiptRule LambdaAction

The LambdaAction property type includes an action in an Amazon SES receipt rule that calls an AWS Lambda function and, optionally, publishes a notification to Amazon SNS.

To enable Amazon SES to call your AWS Lambda function or to publish to an Amazon SNS topic of another account, Amazon SES must have permission to access those resources. For information about giving permissions, see Giving Permissions to Amazon SES for Email Receiving in the Amazon Simple Email Service Developer Guide. For information about using AWS Lambda actions in receipt rules, see Lambda Action in the Amazon Simple Email Service Developer Guide.

LambdaAction is a property of the Amazon Simple Email Service ReceiptRule Action property type.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "FunctionArn" : String, "TopicArn" : String, "InvocationType" : String }

YAML

FunctionArn: String TopicArn: String InvocationType: String

Properties

FunctionArn

The Amazon Resource Name (ARN) of the AWS Lambda function. An example of an AWS Lambda function ARN is arn:aws:lambda:us-west-2:account-id:function:MyFunction.

Required: Yes

Type: String

Update requires: No interruption

InvocationType

The invocation type of the AWS Lambda function. An invocation type of RequestResponse means that the execution of the function will immediately result in a response, and a value of Event means that the function will be invoked asynchronously. The default value is Event. For information about AWS Lambda invocation types, see Invoke in the AWS Lambda Developer Guide.

Valid values include Event and RequestResponse.

Important

There is a 30-second timeout on RequestResponse invocations. You should use Event invocation in most cases. Use RequestResponse only when you want to make a mail flow decision, such as whether to stop the receipt rule or the receipt rule set.

Required: No

Type: String

Update requires: No interruption

TopicArn

The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the Lambda action is taken. An example of an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic.

Required: No

Type: String

Update requires: No interruption

See Also

On this page: