Terraform resource: aws lb listener

aws_lb_listener (tf.io)

• protocol ref

Arguments

Required:

• load_balancer_arn
• default_action

Optional:

• target_group_arn
• ssl_policy (mandatory for HTTPS listeners)

• aws_lb_listener: default_action
• certificate_arn
• target_group_arn
• stickiness https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/lb_listener#stickiness
• protocol: (ref). ALB: HTTP and HTTPS. For Network Load Balancers, valid values are TCP, TLS, UDP
• Action: forward, redirect, fixed-response, authenticate-cognito and authenticate-oidc (ref)

Official example

resource "aws_lb" "front_end" {
 # ...
}

resource "aws_lb_target_group" "front_end" {
 # ...
}

resource "aws_lb_listener" "front_end" {
 load_balancer_arn = aws_lb.front_end.arn
 port              = "443"
 protocol          = "HTTPS"
 ssl_policy        = "ELBSecurityPolicy-2016-08"
 certificate_arn   = "arn:aws:iam::187416307283:server-certificate/test_cert_rab3wuqwgja25ct3n4jdj2tzu4"

 default_action {
   type             = "forward"
   target_group_arn = aws_lb_target_group.front_end.arn
 }
}

Examples

https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/lb_listener#redirect-action

resource "aws_lb_listener" "front_end" {
 load_balancer_arn = aws_lb.front_end.arn
 port              = "80"
 protocol          = "HTTP"

 default_action {
   type = "redirect"

   redirect {
     port        = "443"
     protocol    = "HTTPS"
     status_code = "HTTP_301"
   }
 }
}

Related

• Create an HTTPS listener for your Application Load Balancer

Errors

• Error: Unsupported argument
• Error: creating ELBv2 Listener
• UnsupportedCertificate
• IncompatibleProtocols
• api error ValidationError: A certificate must be specified for HTTPS listeners

Related terms

• aws elb create-load-balancer-listeners
• aws_lb_listener_rule
• DNS name
• Terraform data: aws_lb_listener
• elb.amazonaws.com

See also

• AWS ALB listener: aws_lb_listener (data): certificate_arn, ssl_policy, Pending validation, default_action
• Terraform LB: aws_lb (resource): load_balancer_type, drop_invalid_header_fields, aws_lb (data), aws_lb_listener, aws_lb_listener_certificate
• Terraform AWS resources: IAM, Net, EC2, ECS, ECR, S3, Route53, ACM, CloudWatch, CloudFront SES, RDS, DLM