feat: FIFO throughput scope (#63)

Author: magreenbaum

README.md

@@ -135,13 +135,13 @@ module "sns_topic" {
 | Name | Version |
 |------|---------|
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 1.0 |
-| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 5.25 |
+| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 5.98 |
 
 ## Providers
 
 | Name | Version |
 |------|---------|
-| <a name="provider_aws"></a> [aws](#provider\_aws) | >= 5.25 |
+| <a name="provider_aws"></a> [aws](#provider\_aws) | >= 5.98 |
 
 ## Modules
 
@@ -172,6 +172,7 @@ No modules.
 | <a name="input_delivery_policy"></a> [delivery\_policy](#input\_delivery\_policy) | The SNS delivery policy | `string` | `null` | no |
 | <a name="input_display_name"></a> [display\_name](#input\_display\_name) | The display name for the SNS topic | `string` | `null` | no |
 | <a name="input_enable_default_topic_policy"></a> [enable\_default\_topic\_policy](#input\_enable\_default\_topic\_policy) | Specifies whether to enable the default topic policy. Defaults to `true` | `bool` | `true` | no |
+| <a name="input_fifo_throughput_scope"></a> [fifo\_throughput\_scope](#input\_fifo\_throughput\_scope) | Enables higher throughput for FIFO topics by adjusting the scope of deduplication. This attribute has two possible values, Topic and MessageGroup | `string` | `null` | no |
 | <a name="input_fifo_topic"></a> [fifo\_topic](#input\_fifo\_topic) | Boolean indicating whether or not to create a FIFO (first-in-first-out) topic | `bool` | `false` | no |
 | <a name="input_firehose_feedback"></a> [firehose\_feedback](#input\_firehose\_feedback) | Map of IAM role ARNs and sample rate for success and failure feedback | `map(string)` | `{}` | no |
 | <a name="input_http_feedback"></a> [http\_feedback](#input\_http\_feedback) | Map of IAM role ARNs and sample rate for success and failure feedback | `map(string)` | `{}` | no |

examples/complete/README.md

@@ -23,13 +23,13 @@ Note that this example may create resources which cost money. Run `terraform des
 | Name | Version |
 |------|---------|
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 1.0 |
-| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 5.25 |
+| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 5.98 |
 
 ## Providers
 
 | Name | Version |
 |------|---------|
-| <a name="provider_aws"></a> [aws](#provider\_aws) | >= 5.25 |
+| <a name="provider_aws"></a> [aws](#provider\_aws) | >= 5.98 |
 
 ## Modules
 

examples/complete/main.tf

@@ -62,6 +62,7 @@ module "complete_sns" {
 
   # SQS queue must be FIFO as well
   fifo_topic                  = true
+  fifo_throughput_scope       = "MessageGroup"
   content_based_deduplication = true
 
   delivery_policy = jsonencode({

examples/complete/versions.tf

@@ -4,7 +4,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = ">= 5.25"
+      version = ">= 5.98"
     }
   }
 }

main.tf

@@ -21,6 +21,7 @@ resource "aws_sns_topic" "this" {
   content_based_deduplication = var.content_based_deduplication
   delivery_policy             = var.delivery_policy
   display_name                = var.display_name
+  fifo_throughput_scope       = var.fifo_throughput_scope
   fifo_topic                  = var.fifo_topic
   signature_version           = var.fifo_topic ? null : var.signature_version
   tracing_config              = var.tracing_config

variables.tf

@@ -56,6 +56,12 @@ variable "display_name" {
   default     = null
 }
 
+variable "fifo_throughput_scope" {
+  description = "Enables higher throughput for FIFO topics by adjusting the scope of deduplication. This attribute has two possible values, Topic and MessageGroup"
+  type        = string
+  default     = null
+}
+
 variable "fifo_topic" {
   description = "Boolean indicating whether or not to create a FIFO (first-in-first-out) topic"
   type        = bool

versions.tf

@@ -4,7 +4,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = ">= 5.25"
+      version = ">= 5.98"
     }
   }
 }

wrappers/main.tf

@@ -13,6 +13,7 @@ module "wrapper" {
   delivery_policy                 = try(each.value.delivery_policy, var.defaults.delivery_policy, null)
   display_name                    = try(each.value.display_name, var.defaults.display_name, null)
   enable_default_topic_policy     = try(each.value.enable_default_topic_policy, var.defaults.enable_default_topic_policy, true)
+  fifo_throughput_scope           = try(each.value.fifo_throughput_scope, var.defaults.fifo_throughput_scope, null)
   fifo_topic                      = try(each.value.fifo_topic, var.defaults.fifo_topic, false)
   firehose_feedback               = try(each.value.firehose_feedback, var.defaults.firehose_feedback, {})
   http_feedback                   = try(each.value.http_feedback, var.defaults.http_feedback, {})

wrappers/versions.tf

@@ -4,7 +4,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = ">= 5.25"
+      version = ">= 5.98"
     }
   }
 }