From 161c52721565508648f13098d1b6e8e60bc93149 Mon Sep 17 00:00:00 2001
From: archiev4 <archie.v4.11@gmail.com>
Date: Mon, 9 Mar 2026 11:17:22 +0530
Subject: [PATCH 1/4] New serverless pattern - eventbridge-fanout-pattern

---
 eventbridge-fanout-pattern/README.md          | 167 +++++++++
 .../architecture/architecture.png             | Bin 0 -> 50326 bytes
 .../example-pattern.json                      |  58 ++++
 eventbridge-fanout-pattern/main.tf            | 326 ++++++++++++++++++
 eventbridge-fanout-pattern/processor.zip      | Bin 0 -> 990 bytes
 5 files changed, 551 insertions(+)
 create mode 100644 eventbridge-fanout-pattern/README.md
 create mode 100644 eventbridge-fanout-pattern/architecture/architecture.png
 create mode 100644 eventbridge-fanout-pattern/example-pattern.json
 create mode 100644 eventbridge-fanout-pattern/main.tf
 create mode 100644 eventbridge-fanout-pattern/processor.zip

diff --git a/eventbridge-fanout-pattern/README.md b/eventbridge-fanout-pattern/README.md
new file mode 100644
index 0000000000..6092a1ecf3
--- /dev/null
+++ b/eventbridge-fanout-pattern/README.md
@@ -0,0 +1,167 @@
+# EventBridge fan-out pattern in Terraform
+
+This Terraform pattern demonstrates schedule fan-out using Amazon EventBridge Scheduler. A single schedule puts an event onto a custom EventBridge Event Bus, which routes it to three downstream targets simultaneously which includes an AWS Lambda function for processing, an Amazon SNS topic for notifications, and an Amazon SQS queue for archival. Each target is matched by its own EventBridge Rule on the bus, so new targets can be added without modifying the schedule itself. Every target is fully decoupled and if one fails, the others are unaffected.
+
+Learn more about this pattern at Serverless Land Patterns: https://serverlessland.com/patterns/eventbridge-fanout-pattern
+
+Important: this application uses various AWS services and there are costs associated with these services after the Free Tier usage - please see the [AWS Pricing page](https://aws.amazon.com/pricing/) for details. You are responsible for any AWS costs incurred. No warranty is implied in this example.
+
+## Requirements
+
+* [Create an AWS account](https://portal.aws.amazon.com/gp/aws/developer/registration/index.html) if you do not already have one and log in. The IAM user that you use must have sufficient permissions to make necessary AWS service calls and manage AWS resources.
+* [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) installed and configured
+* [Git Installed](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+* [Terraform](https://learn.hashicorp.cxom/tutorials/terraform/install-cli?in=terraform/aws-get-started) installed
+
+## Deployment Instructions
+
+1. Create a new directory, navigate to that directory in a terminal and clone the GitHub repository:
+    ``` 
+    git clone https://github.com/aws-samples/serverless-patterns
+    ```
+1. Change directory to the pattern directory:
+    ```
+    cd eventbridge-fanout-pattern
+    ```
+1. From the command line, initialize terraform to downloads and installs the providers defined in the configuration:
+    ```
+    terraform init
+    ```
+1. From the command line, apply the configuration in the main.tf file:
+    ```
+    terraform apply -auto-approve
+    ```
+1. During the prompts:
+    #var.aws_region
+    - Enter a value: {enter the region for deployment}
+
+    #var.prefix
+    - Enter a value: {enter any prefix to associate with resources}
+
+1. Note the outputs from the Terraform deployment process. These contain the resource names and/or ARNs which are used for testing.
+
+## How it works
+
+![architecture](architecture/architecture.png)
+
+Amazon EventBridge Scheduler runs a single schedule on a five minute rate and targets a custom EventBridge Event Bus which is the core of the fan-out pattern. Because Scheduler only supports one target per schedule, the bus acts as a routing hub. Three EventBridge Rules sit on that bus, each matching the same event pattern and forwarding the event simultaneously to three independent targets namely an AWS Lambda function that processes the payload, an Amazon SNS topic that delivers notifications to subscribers, and an Amazon SQS queue that stores the event for archival or downstream consumption. If one target fails or is removed, the others continue to work without interruption.
+
+## Testing
+
+The scheduler fires once every five minutes and puts an event onto a custom EventBridge Event Bus. Three rules on that bus match the event and fan it out simultaneously to a Lambda function, an SNS topic, and an SQS queue. 
+
+To test the full flow without waiting for the next five-minute trigger, you can publish the same event to the bus manually using the AWS CLI put-events command and verify within seconds that Lambda logs the event, a message appears in the SQS queue, and SNS delivers to any confirmed subscribers.
+
+1. After deploying the stack, create a Subscriber for your Amazon SNS topic (For ex, your email) and confirm the subscription.
+    https://docs.aws.amazon.com/sns/latest/dg/sns-create-subscribe-endpoint-to-topic.html
+
+1. Publish the event in the custom bus using the following CLI command:
+    ```
+    PREFIX=$(terraform output -raw prefix)
+    ```
+    
+    ```
+    aws events put-events --entries '[
+        {
+            "Source": "'$PREFIX'.scheduler.fan-out",
+            "DetailType": "ScheduledTask",
+            "EventBusName": "'$PREFIX'-scheduled-bus",
+            "Detail": "{\"taskId\":\"manual-testing\",\"message\":\"manual-test-message-1\"}"
+        }
+    ]'
+    ```
+
+1. Now check the CloudWatch logs for the Lambda function to see if the message has been processed
+    ```
+    aws logs tail /aws/lambda/$PREFIX-scheduled-processor --since 2m --format short
+    ```
+    You should see an output like this:
+    ```
+    {
+        "statusCode": 200,
+        "taskId": "manual-test",
+        "result": {
+            "echo": {
+                "taskId": "manual-testing",
+                "message": "manual-test-message-1"
+            }
+        },
+        "processedAt": "2026-03-09TXXXXX",
+        "requestId": "a730a9b9-fbXXXXXX"
+    }
+    ```
+    This means that the message has been processed by the Lambda function
+
+1. Check the SQS queue to see if the message has been received
+    ```
+    aws sqs receive-message --queue-url $(terraform output -raw sqs_queue_url) --wait-time-seconds 5
+    ```
+    You should see an output in this format:
+    ```
+    {
+    "Messages": [
+        {
+            "MessageId": "e6be124b-XXXX",
+            "ReceiptHandle": "AQEBXXXX",
+            "MD5OfBody": "dff96eXXXXX",
+            "Body": {
+                "version": "0",
+                "id": "417a39aXXXXX",
+                "detail-type": "ScheduledTask",
+                "source": "<prefix>.scheduler.fan-out",
+                "account": "123456789012",
+                "time": "2025-01-15TXXXX",
+                "region": "<region>",
+                "resources": [],
+                "detail": {
+                    "taskId": "manual-testing",
+                    "message": "manual-test-message-1"
+                }
+            }
+        }
+    ]}
+    ```
+
+1. The SNS topic will send the message to the confirmed subscriber so check the subscriber (for ex, email) to see the message.
+    ```
+    {
+        "version": "0",
+        "id": "df58af75-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+        "detail-type": "ScheduledTask",
+        "source": "<prefix>.scheduler.fan-out",
+        "account": "123456789012",
+        "time": "2025-01-15T10:30:00Z",
+        "region": "<region>",
+        "resources": [],
+        "detail": {
+            "taskId": "manual-testing",
+            "message": "manual-test-message-1"
+        }     
+    }
+    ```
+
+## Cleanup
+
+1. Change directory to the pattern directory:
+    ```
+    cd serverless-patterns/eventbridge-fanout-pattern
+    ```
+
+1. Delete all created resources
+    ```
+    terraform destroy -auto-approve
+    ```
+    
+1. During the prompts:
+    ```
+    Enter all details as entered during creation.
+    ```
+
+1. Confirm all created resources has been deleted
+    ```
+    terraform show
+    ```
+----
+Copyright 2026 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+SPDX-License-Identifier: MIT-0
\ No newline at end of file
diff --git a/eventbridge-fanout-pattern/architecture/architecture.png b/eventbridge-fanout-pattern/architecture/architecture.png
new file mode 100644
index 0000000000000000000000000000000000000000..f0a35a0eb191b569ff5eac4b6da71ac69e92b0fa
GIT binary patch
literal 50326
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

literal 0
HcmV?d00001

diff --git a/eventbridge-fanout-pattern/example-pattern.json b/eventbridge-fanout-pattern/example-pattern.json
new file mode 100644
index 0000000000..d35886ad2f
--- /dev/null
+++ b/eventbridge-fanout-pattern/example-pattern.json
@@ -0,0 +1,58 @@
+{
+  "title": "EventBridge Scheduler fan-out pattern",
+  "description": "Create an Amazon EventBridge Scheduler that fans out to multiple targets via a custom Event Bus",
+  "language": "Python",
+  "level": "200",
+  "framework": "Terraform",
+  "introBox": {
+    "headline": "How it works",
+    "text": [
+      "This sample project demonstrates how to use Amazon EventBridge Scheduler to trigger multiple downstream targets from a single schedule. Since Scheduler supports only one target per schedule, this pattern uses a custom EventBridge Event Bus as the fan-out hub."
+    ]
+  },
+  "gitHub": {
+    "template": {
+      "repoURL": "https://github.com/aws-samples/serverless-patterns/tree/main/eventbridge-fanout-pattern",
+      "templateURL": "serverless-patterns/eventbridge-fanout-pattern",
+      "projectFolder": "eventbridge-fanout-pattern",
+      "templateFile": "main.tf"
+    }
+  },
+  "resources": {
+    "bullets": [
+      {
+        "text": "Creating Amazon EventBridge event patterns",
+        "link": "https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html"
+      },
+      {
+        "text": "Event buses in Amazon EventBridge",
+        "link": "https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html"
+      }
+    ]
+  },
+  "deploy": {
+    "text": [
+      "terraform init",
+      "terraform apply"
+    ]
+  },
+  "testing": {
+    "text": [
+      "See the GitHub repo for detailed testing instructions."
+    ]
+  },
+  "cleanup": {
+    "text": [
+      "terraform destroy",
+      "terraform show"
+    ]
+  },
+  "authors": [
+    {
+      "name": "Archana V",
+      "image": "https://media.licdn.com/dms/image/v2/D5603AQGhkVtEhllFEw/profile-displayphoto-shrink_400_400/B56ZZH3LL6H0Ag-/0/1744962369913?e=1774483200&v=beta&t=wAhvwq-jEIWnyQwDfIkK_-Sq16Z4RvpjWtYmDkc3eg4",
+      "bio": "Solutions Architect at AWS",
+      "linkedin": "archanavenkat"
+    }
+  ]
+}
diff --git a/eventbridge-fanout-pattern/main.tf b/eventbridge-fanout-pattern/main.tf
new file mode 100644
index 0000000000..a0680cc7c3
--- /dev/null
+++ b/eventbridge-fanout-pattern/main.tf
@@ -0,0 +1,326 @@
+terraform {
+  required_version = ">= 1.5"
+  required_providers {
+    aws = {
+      source  = "hashicorp/aws"
+      version = "~> 5.0"
+    }
+  }
+}
+
+provider "aws" {
+  region = var.aws_region
+}
+
+############################################################
+# Variables
+############################################################
+
+variable "aws_region" {
+  description = "AWS region for resources (e.g. us-east-1, us-west-2)"
+  type        = string
+
+  validation {
+    condition     = can(regex("^[a-z]{2}-[a-z]+-[0-9]+$", var.aws_region))
+    error_message = "Must be a valid AWS region (e.g. us-east-1, eu-west-2)."
+  }
+}
+
+variable "prefix" {
+  description = "Unique prefix for all resource names"
+  type        = string
+
+  validation {
+    condition     = can(regex("^[a-z0-9][a-z0-9\\-]{1,20}$", var.prefix))
+    error_message = "Prefix must be 2-21 lowercase alphanumeric characters or hyphens."
+  }
+}
+
+variable "log_retention_days" {
+  description = "CloudWatch log retention in days (0 = never expire)"
+  type        = number
+  default     = 14
+}
+
+############################################################
+# Data Sources
+############################################################
+
+data "aws_caller_identity" "current" {}
+
+############################################################
+# 1. CUSTOM EVENT BUS (the fan-out hub)
+############################################################
+
+resource "aws_cloudwatch_event_bus" "scheduled_bus" {
+  name = "${var.prefix}-scheduled-bus"
+}
+
+############################################################
+# 2. TARGETS — Lambda (Python), SNS, SQS
+############################################################
+
+# --- Lambda ---
+
+resource "aws_iam_role" "lambda_role" {
+  name = "${var.prefix}-processor-lambda-role"
+
+  assume_role_policy = jsonencode({
+    Version = "2012-10-17"
+    Statement = [{
+      Action = "sts:AssumeRole"
+      Effect = "Allow"
+      Principal = { Service = "lambda.amazonaws.com" }
+    }]
+  })
+}
+
+resource "aws_iam_role_policy_attachment" "lambda_basic" {
+  role       = aws_iam_role.lambda_role.name
+  policy_arn = "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"
+}
+
+# Create log group BEFORE the Lambda so Terraform owns it
+resource "aws_cloudwatch_log_group" "processor_logs" {
+  name              = "/aws/lambda/${var.prefix}-scheduled-processor"
+  retention_in_days = var.log_retention_days
+}
+
+resource "aws_lambda_function" "processor" {
+  function_name    = "${var.prefix}-scheduled-processor"
+  role             = aws_iam_role.lambda_role.arn
+  handler          = "processor.lambda_handler"
+  runtime          = "python3.12"
+  timeout          = 30
+  memory_size      = 128
+  filename         = "processor.zip"
+
+  environment {
+    variables = {
+      PREFIX    = var.prefix
+      ENV       = "production"
+      LOG_LEVEL = "INFO"
+    }
+  }
+
+  depends_on = [
+    aws_cloudwatch_log_group.processor_logs,
+    aws_iam_role_policy_attachment.lambda_basic,
+  ]
+}
+
+# --- SNS ---
+
+resource "aws_sns_topic" "alerts" {
+  name = "${var.prefix}-scheduled-alerts"
+}
+
+# --- SQS ---
+
+resource "aws_sqs_queue" "archive" {
+  name = "${var.prefix}-scheduled-archive"
+}
+
+############################################################
+# 3. EVENT RULES (fan-out from bus to targets)
+############################################################
+
+locals {
+  event_pattern = jsonencode({
+    source      = ["${var.prefix}.scheduler.fan-out"]
+    detail-type = ["ScheduledTask"]
+  })
+}
+
+# --- Rule #1 → Lambda ---
+
+resource "aws_cloudwatch_event_rule" "process_rule" {
+  name           = "${var.prefix}-process-scheduled-event"
+  event_bus_name = aws_cloudwatch_event_bus.scheduled_bus.name
+  event_pattern  = local.event_pattern
+}
+
+resource "aws_cloudwatch_event_target" "lambda_target" {
+  rule           = aws_cloudwatch_event_rule.process_rule.name
+  event_bus_name = aws_cloudwatch_event_bus.scheduled_bus.name
+  target_id      = "${var.prefix}-send-to-lambda"
+  arn            = aws_lambda_function.processor.arn
+}
+
+resource "aws_lambda_permission" "allow_eventbridge" {
+  statement_id  = "AllowEventBridgeInvoke"
+  action        = "lambda:InvokeFunction"
+  function_name = aws_lambda_function.processor.function_name
+  principal     = "events.amazonaws.com"
+  source_arn    = aws_cloudwatch_event_rule.process_rule.arn
+}
+
+# --- Rule #2 → SNS ---
+
+resource "aws_cloudwatch_event_rule" "notify_rule" {
+  name           = "${var.prefix}-notify-scheduled-event"
+  event_bus_name = aws_cloudwatch_event_bus.scheduled_bus.name
+  event_pattern  = local.event_pattern
+}
+
+resource "aws_cloudwatch_event_target" "sns_target" {
+  rule           = aws_cloudwatch_event_rule.notify_rule.name
+  event_bus_name = aws_cloudwatch_event_bus.scheduled_bus.name
+  target_id      = "${var.prefix}-send-to-sns"
+  arn            = aws_sns_topic.alerts.arn
+}
+
+resource "aws_sns_topic_policy" "allow_eventbridge" {
+  arn = aws_sns_topic.alerts.arn
+
+  policy = jsonencode({
+    Version = "2012-10-17"
+    Statement = [{
+      Sid       = "AllowEventBridgePublish"
+      Effect    = "Allow"
+      Principal = { Service = "events.amazonaws.com" }
+      Action    = "sns:Publish"
+      Resource  = aws_sns_topic.alerts.arn
+      Condition = {
+        ArnEquals = {
+          "aws:SourceArn" = aws_cloudwatch_event_rule.notify_rule.arn
+        }
+      }
+    }]
+  })
+}
+
+# --- Rule #3 → SQS ---
+
+resource "aws_cloudwatch_event_rule" "archive_rule" {
+  name           = "${var.prefix}-archive-scheduled-event"
+  event_bus_name = aws_cloudwatch_event_bus.scheduled_bus.name
+  event_pattern  = local.event_pattern
+}
+
+resource "aws_cloudwatch_event_target" "sqs_target" {
+  rule           = aws_cloudwatch_event_rule.archive_rule.name
+  event_bus_name = aws_cloudwatch_event_bus.scheduled_bus.name
+  target_id      = "${var.prefix}-send-to-sqs"
+  arn            = aws_sqs_queue.archive.arn
+}
+
+resource "aws_sqs_queue_policy" "allow_eventbridge" {
+  queue_url = aws_sqs_queue.archive.id
+
+  policy = jsonencode({
+    Version = "2012-10-17"
+    Statement = [{
+      Sid       = "AllowEventBridgeSend"
+      Effect    = "Allow"
+      Principal = { Service = "events.amazonaws.com" }
+      Action    = "sqs:SendMessage"
+      Resource  = aws_sqs_queue.archive.arn
+      Condition = {
+        ArnEquals = {
+          "aws:SourceArn" = aws_cloudwatch_event_rule.archive_rule.arn
+        }
+      }
+    }]
+  })
+}
+
+############################################################
+# 4. SCHEDULER → EVENT BUS (the single schedule)
+############################################################
+
+resource "aws_iam_role" "scheduler_role" {
+  name = "${var.prefix}-scheduler-eventbridge-role"
+
+  assume_role_policy = jsonencode({
+    Version = "2012-10-17"
+    Statement = [{
+      Action = "sts:AssumeRole"
+      Effect = "Allow"
+      Principal = { Service = "scheduler.amazonaws.com" }
+    }]
+  })
+}
+
+resource "aws_iam_role_policy" "scheduler_put_events" {
+  name = "${var.prefix}-put-events-policy"
+  role = aws_iam_role.scheduler_role.id
+
+  policy = jsonencode({
+    Version = "2012-10-17"
+    Statement = [{
+      Effect   = "Allow"
+      Action   = "events:PutEvents"
+      Resource = aws_cloudwatch_event_bus.scheduled_bus.arn
+    }]
+  })
+}
+
+# Log group for scheduler (delivery logs)
+resource "aws_cloudwatch_log_group" "scheduler_logs" {
+  name              = "/aws/scheduler/${var.prefix}-fan-out"
+  retention_in_days = var.log_retention_days
+}
+
+resource "aws_scheduler_schedule" "fan_out" {
+  name                = "${var.prefix}-fan-out"
+  schedule_expression = "rate(5 minutes)"
+
+  flexible_time_window {
+    mode = "OFF"
+  }
+
+  target {
+    arn      = aws_cloudwatch_event_bus.scheduled_bus.arn
+    role_arn = aws_iam_role.scheduler_role.arn
+
+    eventbridge_parameters {
+      source      = "${var.prefix}.scheduler.fan-out"
+      detail_type = "ScheduledTask"
+    }
+
+    input = jsonencode({
+      taskId  = "5-minute-job"
+      prefix  = var.prefix
+      message = "Triggered by EventBridge Scheduler"
+    })
+  }
+
+  depends_on = [aws_cloudwatch_log_group.scheduler_logs]
+}
+
+############################################################
+# 5. OUTPUTS
+############################################################
+
+output "prefix" {
+  value = var.prefix
+}
+
+output "event_bus_name" {
+  value = aws_cloudwatch_event_bus.scheduled_bus.name
+}
+
+output "event_bus_arn" {
+  value = aws_cloudwatch_event_bus.scheduled_bus.arn
+}
+
+output "schedule_name" {
+  value = aws_scheduler_schedule.fan_out.name
+}
+
+output "schedule_arn" {
+  value = aws_scheduler_schedule.fan_out.arn
+}
+
+output "lambda_function_name" {
+  value = aws_lambda_function.processor.function_name
+}
+
+output "sns_topic_arn" {
+  value = aws_sns_topic.alerts.arn
+}
+
+output "sqs_queue_url" {
+  value = aws_sqs_queue.archive.url
+}
\ No newline at end of file
diff --git a/eventbridge-fanout-pattern/processor.zip b/eventbridge-fanout-pattern/processor.zip
new file mode 100644
index 0000000000000000000000000000000000000000..5e3b1dacb8388f1c2949d76373d2ac16b0aa393b
GIT binary patch
literal 990
zcmWIWW@Zs#U|`^2c<PZE)3udf%z&AJp`C+)frmkcp`a)~IkmVrzeum3GBkvffjQM-
zU1mBEmsW5yFtU7OWMBa6UK$$hf7?K$?)>@<O=?0bUDo7OcN}4M_E9)yw)IVJQ0k+}
zNgi*`lr^k-Re%4ZYUX95Bin4gJSzUZ@BH&QA9hVVHNjff^~m4%Ugw_2oLL-na+X2X
zfe%t124(-<kJSB}#I)!HTZ7W^*c3DN&o}3)W*VeP^*>--wdC{8AD>=kOSxXWXL|Mf
zlQ~>rjh6zCEKu3LDfDVmnR>nuTid5B7cNa6o0%s49CnJD;!AxVd1|wy@dUCg-lWqV
z{CtJO_Nk5;-ruj=ZESMVTDD&^vf<i+M|1W__g^c!rj@lrq(V+UHCeX$cGmV!mGOcf
zullmG6@6l3o-<D}`?Z_8oYSp`hHHfw!=BtUQrR&>R5akCS-tZO)=2_CjMCY}WM)^q
zI`QW1Z+_`1-mC|f@#;Q!r7U&ay?#l}tJQz`?@I|^$VzjVeSO2;qIXAj3BOTDG>B&W
z!>FGZkSyt3s4ckn{7$Z`7Hac;bJv!h>@GcHfAy=aZKLINH{C@qex+1dzSURx)?3w(
z+Z^~h?)$9c@51;Gt-ZBn_FKW4JuU2F(p5PeQg5V}STE0&b(`p1<+}65vh&<w7k{-~
zyt&riTjs0yRV(R^$^Qjz%L)b+9Q^RRqG#>HNfmno#L~BWD|h~tY|{^qOKJ8xXW^`$
z|0(a=m!^f$ce<(-<y~cp_!@izZ!LO#p;zhF+~W&f*%hyMvoW9W>(H-DxbUY&hUwK~
zrf1LZ6r|ftzxVFaj?1b2J}KD^5-*L`rfRUBdQf%J^=s-JcKyx?%ZktZzFGDuVUDQw
z?#VGKc86_sN`zM2SbnYei`Mu3)sCIhCBh#VU5Pv@x$}*$mAd!y9k<>Gv#jb5x%qWU
z!m-j{brD+@F1xyXQsdp-?d=?|-8Qx6CfmkW>RFilbW4dyZ@hJm!F~3+UJ)s_-RF6a
zEO;fcn(yqw`Jdjs+IB{cY1ZF<-R#SIJ^Xs4!~Zv(37E5_+C6Qp=B1wONUzY~$xEzR
z>$X`;=5tyw^`g5i_j6{K)wz2Qdn*>yr~R{vWK-TzYB;xFTzDQ=29ITNd>MC;uflyj
z9xu<SZ+54OCkF;S+WUa*z_)wvmnXOsu&Yhz%egf3XjRSHs2dCpJKOFDcr!A|G2_a2
r62Sb(zyQo!3`-h8EYw`c3dx0NIWWMRl?|kp5eS2TbQv%gGcW)EDnPL#

literal 0
HcmV?d00001


From bd02b77ea5da23d8f7f03e8000734db6ea50c1bf Mon Sep 17 00:00:00 2001
From: archiev4 <archie.v4.11@gmail.com>
Date: Mon, 9 Mar 2026 11:25:56 +0530
Subject: [PATCH 2/4] Changed runtime to py3.14

---
 eventbridge-fanout-pattern/main.tf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/eventbridge-fanout-pattern/main.tf b/eventbridge-fanout-pattern/main.tf
index a0680cc7c3..d9d6343269 100644
--- a/eventbridge-fanout-pattern/main.tf
+++ b/eventbridge-fanout-pattern/main.tf
@@ -90,7 +90,7 @@ resource "aws_lambda_function" "processor" {
   function_name    = "${var.prefix}-scheduled-processor"
   role             = aws_iam_role.lambda_role.arn
   handler          = "processor.lambda_handler"
-  runtime          = "python3.12"
+  runtime          = "python3.14"
   timeout          = 30
   memory_size      = 128
   filename         = "processor.zip"

From 1c0b95335dedbf1590ab3be96233ea5e1dc5b105 Mon Sep 17 00:00:00 2001
From: archiev4 <archie.v4.11@gmail.com>
Date: Mon, 9 Mar 2026 11:36:41 +0530
Subject: [PATCH 3/4] Updated version

---
 eventbridge-fanout-pattern/main.tf | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/eventbridge-fanout-pattern/main.tf b/eventbridge-fanout-pattern/main.tf
index d9d6343269..9984b64f42 100644
--- a/eventbridge-fanout-pattern/main.tf
+++ b/eventbridge-fanout-pattern/main.tf
@@ -1,9 +1,9 @@
 terraform {
-  required_version = ">= 1.5"
+  required_version = ">= 1.0"
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "~> 5.0"
+      version = "~> 6.32.1"
     }
   }
 }

From 66efad46a21b519c22faa32ae182482282602a6e Mon Sep 17 00:00:00 2001
From: archiev4 <archie.v4.11@gmail.com>
Date: Sat, 14 Mar 2026 11:35:08 +0530
Subject: [PATCH 4/4] Fixed link

---
 eventbridge-fanout-pattern/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/eventbridge-fanout-pattern/README.md b/eventbridge-fanout-pattern/README.md
index 6092a1ecf3..10f6368d75 100644
--- a/eventbridge-fanout-pattern/README.md
+++ b/eventbridge-fanout-pattern/README.md
@@ -11,7 +11,7 @@ Important: this application uses various AWS services and there are costs associ
 * [Create an AWS account](https://portal.aws.amazon.com/gp/aws/developer/registration/index.html) if you do not already have one and log in. The IAM user that you use must have sufficient permissions to make necessary AWS service calls and manage AWS resources.
 * [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) installed and configured
 * [Git Installed](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
-* [Terraform](https://learn.hashicorp.cxom/tutorials/terraform/install-cli?in=terraform/aws-get-started) installed
+* [Terraform](https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started) installed
 
 ## Deployment Instructions