feat: added filter criteria for event source mappings (#61)

Author: moritzzimmer

README.md

@@ -128,6 +128,13 @@ module "lambda" {
       batch_size        = 50
       starting_position = "LATEST"
 
+      // Lambda event filtering, see https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html
+      filter_criteria = {
+        pattern = jsonencode({
+          eventName : ["MODIFY"]
+        })
+      }
+
       // optionally configure a SNS or SQS destination for discarded batches, required IAM
       // permissions will be added automatically by this module,
       // see https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html
@@ -201,9 +208,9 @@ see [example](examples/with-cloudwatch-logs-subscription) for details
 module "lambda" {
   // see above
 
-  // disable CloudWatch logs 
-  // cloudwatch_logs_enabled = false 
-  
+  // disable CloudWatch logs
+  // cloudwatch_logs_enabled = false
+
   cloudwatch_logs_retention_in_days = 14
 
   cloudwatch_log_subscription_filters = {
@@ -239,8 +246,6 @@ module "lambda" {
 }
 ```
 
-
-
 For `image` deployment packages, the Lambda Insights extension needs to be added to the [container image](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Lambda-Insights-Getting-Started-docker.html):
 
 ```dockerfile
@@ -297,13 +302,13 @@ should migrate to this module as a drop-in replacement to benefit from new featu
 | Name | Version |
 |------|---------|
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 0.12.0 |
-| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 3.61 |
+| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 4.9 |
 
 ## Providers
 
 | Name | Version |
 |------|---------|
-| <a name="provider_aws"></a> [aws](#provider\_aws) | 4.8.0 |
+| <a name="provider_aws"></a> [aws](#provider\_aws) | >= 4.9 |
 
 ## Modules
 

docs/deployment/part2.md

@@ -3,7 +3,7 @@
 | Name | Version |
 |------|---------|
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 0.12.0 |
-| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 3.19 |
+| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 4.9 |
 
 ## Providers
 

docs/part1.md

@@ -128,6 +128,13 @@ module "lambda" {
       batch_size        = 50
       starting_position = "LATEST"
 
+      // Lambda event filtering, see https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html
+      filter_criteria = {
+        pattern = jsonencode({
+          eventName : ["MODIFY"]
+        })
+      }
+
       // optionally configure a SNS or SQS destination for discarded batches, required IAM
       // permissions will be added automatically by this module,
       // see https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html
@@ -201,9 +208,9 @@ see [example](examples/with-cloudwatch-logs-subscription) for details
 module "lambda" {
   // see above
 
-  // disable CloudWatch logs 
-  // cloudwatch_logs_enabled = false 
-  
+  // disable CloudWatch logs
+  // cloudwatch_logs_enabled = false
+
   cloudwatch_logs_retention_in_days = 14
 
   cloudwatch_log_subscription_filters = {
@@ -239,8 +246,6 @@ module "lambda" {
 }
 ```
 
-
-
 For `image` deployment packages, the Lambda Insights extension needs to be added to the [container image](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Lambda-Insights-Getting-Started-docker.html):
 
 ```dockerfile

docs/part2.md

@@ -3,13 +3,13 @@
 | Name | Version |
 |------|---------|
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 0.12.0 |
-| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 3.61 |
+| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 4.9 |
 
 ## Providers
 
 | Name | Version |
 |------|---------|
-| <a name="provider_aws"></a> [aws](#provider\_aws) | 4.8.0 |
+| <a name="provider_aws"></a> [aws](#provider\_aws) | >= 4.9 |
 
 ## Modules
 

event_source_mappings.tf

@@ -48,6 +48,16 @@ resource "aws_lambda_event_source_mapping" "event_source" {
       }
     }
   }
+
+  dynamic "filter_criteria" {
+    for_each = try(each.value["filter_criteria"], null) != null ? [true] : []
+
+    content {
+      filter {
+        pattern = try(each.value["filter_criteria"].pattern, null)
+      }
+    }
+  }
 }
 
 // type specific minimal permissions for supported event_sources,

examples/deployment/container-image/versions.tf

@@ -2,6 +2,6 @@ terraform {
   required_version = ">= 0.12"
 
   required_providers {
-    aws = ">= 3.61"
+    aws = ">= 4.9"
   }
 }

examples/deployment/s3/versions.tf

@@ -2,6 +2,6 @@ terraform {
   required_version = ">= 0.12"
 
   required_providers {
-    aws = ">= 3.61"
+    aws = ">= 4.9"
   }
 }

examples/simple/versions.tf

@@ -2,6 +2,6 @@ terraform {
   required_version = ">= 0.12"
 
   required_providers {
-    aws = ">= 3.61"
+    aws = ">= 4.9"
   }
 }

examples/with-cloudwatch-event-rules/versions.tf

@@ -2,6 +2,6 @@ terraform {
   required_version = ">= 0.12"
 
   required_providers {
-    aws = ">= 3.61"
+    aws = ">= 4.9"
   }
 }

examples/with-cloudwatch-logs-subscription/versions.tf

@@ -2,6 +2,6 @@ terraform {
   required_version = ">= 0.12"
 
   required_providers {
-    aws = ">= 3.19"
+    aws = ">= 4.9"
   }
 }