This is the new *Amazon CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [Amazon CloudFormation User Guide](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::SES::ReceiptRule LambdaAction
<a name="aws-properties-ses-receiptrule-lambdaaction"></a>

When included in a receipt rule, this action calls an Amazon Lambda function and, optionally, publishes a notification to Amazon Simple Notification Service (Amazon SNS).

To enable Amazon SES to call your Amazon 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 the [Amazon SES Developer Guide](https://docs.amazonaws.cn/ses/latest/dg/receiving-email-permissions.html).

For information about using Amazon Lambda actions in receipt rules, see the [Amazon SES Developer Guide](https://docs.amazonaws.cn/ses/latest/dg/receiving-email-action-lambda.html).

## Syntax
<a name="aws-properties-ses-receiptrule-lambdaaction-syntax"></a>

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

### JSON
<a name="aws-properties-ses-receiptrule-lambdaaction-syntax.json"></a>

```
{
  "[FunctionArn](#cfn-ses-receiptrule-lambdaaction-functionarn)" : String,
  "[InvocationType](#cfn-ses-receiptrule-lambdaaction-invocationtype)" : String,
  "[TopicArn](#cfn-ses-receiptrule-lambdaaction-topicarn)" : String
}
```

### YAML
<a name="aws-properties-ses-receiptrule-lambdaaction-syntax.yaml"></a>

```
  [FunctionArn](#cfn-ses-receiptrule-lambdaaction-functionarn): String
  [InvocationType](#cfn-ses-receiptrule-lambdaaction-invocationtype): String
  [TopicArn](#cfn-ses-receiptrule-lambdaaction-topicarn): String
```

## Properties
<a name="aws-properties-ses-receiptrule-lambdaaction-properties"></a>

`FunctionArn`  <a name="cfn-ses-receiptrule-lambdaaction-functionarn"></a>
The Amazon Resource Name (ARN) of the Amazon Lambda function. An example of an Amazon Lambda function ARN is `arn:aws:lambda:us-west-2:account-id:function:MyFunction`. For more information about Amazon Lambda, see the [Amazon Lambda Developer Guide](https://docs.amazonaws.cn/lambda/latest/dg/welcome.html).  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`InvocationType`  <a name="cfn-ses-receiptrule-lambdaaction-invocationtype"></a>
The invocation type of the Amazon Lambda function. An invocation type of `RequestResponse` means that the execution of the function immediately results in a response, and a value of `Event` means that the function is invoked asynchronously. The default value is `Event`. For information about Amazon Lambda invocation types, see the [Amazon Lambda Developer Guide](https://docs.amazonaws.cn/lambda/latest/dg/API_Invoke.html).  
There is a 30-second timeout on `RequestResponse` invocations. You should use `Event` invocation in most cases. Use `RequestResponse` only to make a mail flow decision, such as whether to stop the receipt rule or the receipt rule set.
*Required*: No  
*Type*: String  
*Allowed values*: `Event | RequestResponse`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TopicArn`  <a name="cfn-ses-receiptrule-lambdaaction-topicarn"></a>
The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the Lambda action is executed. You can find the ARN of a topic by using the [ListTopics](https://docs.amazonaws.cn/sns/latest/api/API_ListTopics.html) operation in Amazon SNS.  
For more information about Amazon SNS topics, see the [Amazon SNS Developer Guide](https://docs.amazonaws.cn/sns/latest/dg/CreateTopic.html).  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)