AWS::ElasticLoadBalancing::LoadBalancer Listeners - AWS CloudFormation

AWS::ElasticLoadBalancing::LoadBalancer Listeners

Specifies a listener for your Classic Load Balancer.

Modifying any property replaces the listener.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "InstancePort" : String, "InstanceProtocol" : String, "LoadBalancerPort" : String, "PolicyNames" : [ String, ... ], "Protocol" : String, "SSLCertificateId" : String }

YAML

InstancePort: String InstanceProtocol: String LoadBalancerPort: String PolicyNames: - String Protocol: String SSLCertificateId: String

Properties

InstancePort

The port on which the instance is listening.

Required: Yes

Type: String

Minimum: 1

Maximum: 65535

Update requires: Some interruptions

InstanceProtocol

The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS.

If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

Required: No

Type: String

Update requires: Some interruptions

LoadBalancerPort

The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.

Required: Yes

Type: String

Update requires: Some interruptions

PolicyNames

The names of the policies to associate with the listener.

Required: No

Type: Array of String

Update requires: Some interruptions

Protocol

The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.

Required: Yes

Type: String

Update requires: Some interruptions

SSLCertificateId

The Amazon Resource Name (ARN) of the server certificate.

Required: No

Type: String

Update requires: Some interruptions

See also