variables.tf

#---------------------------------------------------------------------------------------------------
# General
#---------------------------------------------------------------------------------------------------

variable "naming_prefix" {
  type        = string
  description = "Naming prefix used to name all resources"
}

variable "lambda_description" {
  description = "Lambda function description."
  type        = string
  default     = "This function sends AWS cost notifications. Source: github.com/cloudandthings/terraform-aws-costnotifier"
}

variable "tags" {
  description = "A mapping of tags to assign to the resources."
  type        = map(string)
  default     = {}
}

variable "cloudwatch_logs_retention_in_days" {
  description = "Specifies the number of days you want to retain log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, and 3653."
  type        = number
  default     = 14
}

variable "lambda_runtime" {
  type        = string
  description = "The lambda runtime to use. One of: `[\"python3.9\", \"python3.8\", \"python3.7\"]`"
  default     = "python3.8"

  validation {
    condition = contains([
      "python3.9",
      "python3.8",
      "python3.7"
    ], var.lambda_runtime)
    error_message = "Invalid lambda_runtime provided."
  }
}

#---------------------------------------------------------------------------------------------------
# Notifications
#---------------------------------------------------------------------------------------------------

variable "account_name" {
  type        = string
  description = "Name of your account to Identify your account in the notification message"
}

variable "notification_schedule" {
  type        = string
  description = "CRON expression to schedule notification"
  default     = "cron(0 20 ? * MON-SUN *)"
}

variable "webhook_urls" {
  type        = list(string)
  description = "Webhook URLs to receive daily cost notifications on either Slack or Teams"
  # Slack URLs are sensitive, for example
  sensitive = true
}

variable "webhook_type" {
  description = "Either \"slack\" or \"teams\"."
  type        = string
  default     = "slack"
  validation {
    condition     = contains(["slack", "teams"], lower(var.webhook_type))
    error_message = "Must be one of: \"slack\", \"teams\"."
  }
}

variable "emails_for_notifications" {
  type        = list(string)
  description = "List of emails to receive cost notifier notifications"
  default     = []
}

#---------------------------------------------------------------------------------------------------
# Thresholds
#---------------------------------------------------------------------------------------------------

variable "amber_threshold" {
  type        = string
  description = "Percentage exceeded threshold to send an amber alert and notify the slack channel"
  default     = "20"
}

variable "red_threshold" {
  type        = string
  description = "Percentage exceeded threshold to send a red alert and notify the slack channel"
  default     = "50"
}

#---------------------------------------------------------------------------------------------------
# IAM
#---------------------------------------------------------------------------------------------------

variable "create_role" {
  description = "Controls whether IAM role for Lambda Function should be created"
  type        = bool
  default     = true
}

variable "lambda_role" {
  description = "IAM role ARN attached to the Lambda Function. This governs both who / what can invoke your Lambda Function, as well as what resources our Lambda Function has access to. See Lambda Permission Model for more details."
  type        = string
  default     = ""
}

variable "permissions_boundary" {
  description = "ARN of the policy that is used to set the permissions boundary for the role."
  type        = string
  default     = null
}

#---------------------------------------------------------------------------------------------------
# Network
#---------------------------------------------------------------------------------------------------

variable "security_group_ids" {
  description = "List of VPC security group IDs associated with the Lambda function."
  type        = list(string)
  default     = []
}

variable "subnet_ids" {
  description = "List of VPC subnet IDs associated with the Lambda function."
  type        = list(string)
  default     = []
}

#---------------------------------------------------------------------------------------------------
# KMS
#---------------------------------------------------------------------------------------------------

variable "kms_key_arn" {
  description = "The alias, alias ARN, key ID, or key ARN of an AWS KMS key used to encrypt all resources."
  type        = string
  default     = null
}

#---------------------------------------------------------------------------------------------------
# Deployment
#---------------------------------------------------------------------------------------------------

variable "s3_bucket" {
  description = "S3 bucket for deployment package."
  type        = string
  default     = null
}

variable "s3_key" {
  description = "S3 object key for deployment package. Otherwise, defaults to `var.naming_prefix/local.deployment_filename`."
  type        = string
  default     = null
}

variable "upload_deployment_to_s3" {
  description = "If `true`, the deployment package within this module repo will be copied to S3. If `false` then the S3 object must be uploaded separately. Ignored if `s3_bucket` is null."
  type        = bool
  default     = true
}