README.md

AWS SNS SMS Module

This module creates AWS SNS SMS Settings and CloudWatch alarm for the SMS limit.

NOTE! Can be used only when AWS SNS is out of the SMS Sandbox.

AWS Documentation: Moving out of the SMS sandbox

Example

# main.tf
module "sms" {
  source = "git::https://github.com/lpavliuk/Terraform-Modules.git//aws_sns_sms"

  sms_limit_usd          = 50
  default_sender_id      = "Example"
  default_sms_type       = "Transactional"

  notification_topic_arn = local.notification_topic_arn # Creates CloudWatch Alarm
}

Requirements

Name	Version
terraform	< 2.0.0, >= 1.6.6
aws	< 6.0, >= 5.22

Inputs

Name	Description	Type	Default	Required
sms_limit_usd	SMS Limit amount in USD	number	n/a	yes
default_sender_id	Default Sender ID	string	""	no
default_sms_type	Default SMS message type. Available: Promotional, Transactional	string	""	no
notification_topic_arn	SNS Topic ARN for CloudWatch alarm actions	string	""	no
sms_limit_alarm_threshold_percent	Threshold in percent of the SMS Limit alarm	number	90	no

Outputs

Name	Description
sms_limit_usd	SMS Limit in USD
default_sender_id	Default Sender ID
default_sms_type	Default SMS type
sms_limit_alarm_arn	SMS Limit CloudWatch Alarm ARN
sms_limit_alarm_name	SMS Limit CloudWatch Alarm Name
sms_limit_alarm_threshold	SMS Limit CloudWatch Alarm Threshold

Resources

Name	Type
aws_cloudwatch_metric_alarm.this	resource
aws_sns_sms_preferences.this	resource
aws_caller_identity.current	data source