CreateLoadBalancerListeners - Elastic Load Balancing


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 AWS Identity and Access Management (IAM) or AWS 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 AWS SDKs, see the following: