CreateLoadBalancerListeners - Elastic Load Balancing
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Creates one or more listeners for the specified load balancer. If a listener with the specified port does not already exist, it is created; otherwise, the properties of the new listener must match the properties of the existing listener.

For more information, see Listeners for your Classic Load Balancer in the User Guide for Classic Load Balancers.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.


The listeners.

Type: Array of Listener objects

Required: Yes


The name of the load balancer.

Type: String

Required: Yes


For information about the errors that are common to all actions, see Common Errors.


The specified ARN does not refer to a valid SSL certificate in Amazon Identity and Access Management (IAM) or Amazon Certificate Manager (ACM). Note that if you recently uploaded the certificate to IAM, this error might indicate that the certificate is not fully available yet.

HTTP Status Code: 400


A listener already exists for the specified load balancer name and port, but with a different instance port, protocol, or SSL certificate.

HTTP Status Code: 400


The requested configuration change is not valid.

HTTP Status Code: 409


The specified load balancer does not exist.

HTTP Status Code: 400


The specified protocol or signature version is not supported.

HTTP Status Code: 400


Create an HTTPS listener

This example creates a listener for the specified load balancer using port 443 and the HTTPS protocol.

Sample Request &LoadBalancerName=my-https-loadbalancer &Listeners.member.1.Protocol=https &Listeners.member.1.LoadBalancerPort=443 &Listeners.member.1.InstancePort=443 &Listeners.member.1.InstanceProtocol=https &Listeners.member.1.SSLCertificateId=arn:aws:iam::123456789012:server-certificate/my-server-cert &Version=2012-06-01 &AUTHPARAMS

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: