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
whoseInstanceProtocol
is secure, (HTTPS or SSL), the listener'sInstanceProtocol
must also be secure.If there is another listener with the same
InstancePort
whoseInstanceProtocol
is HTTP or TCP, the listener'sInstanceProtocol
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
-
CreateLoadBalancerListeners in the Elastic Load Balancing API Reference (version 2012-06-01)
-
Listeners in the User Guide for Classic Load Balancers
-
HTTPS Listeners in the User Guide for Classic Load Balancers