SetLoadBalancerListenerSSLCertificate - Elastic Load Balancing

SetLoadBalancerListenerSSLCertificate

Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces any prior certificate that was used on the same load balancer and port.

For more information about updating your SSL certificate, see Replace the SSL certificate 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.

LoadBalancerName

The name of the load balancer.

Type: String

Required: Yes

LoadBalancerPort

The port that uses the specified SSL certificate.

Type: Integer

Required: Yes

SSLCertificateId

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

Type: String

Required: Yes

Errors

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

CertificateNotFound

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

InvalidConfigurationRequest

The requested configuration change is not valid.

HTTP Status Code: 409

ListenerNotFound

The load balancer does not have a listener configured at the specified port.

HTTP Status Code: 400

LoadBalancerNotFound

The specified load balancer does not exist.

HTTP Status Code: 400

UnsupportedProtocol

The specified protocol or signature version is not supported.

HTTP Status Code: 400

Examples

Update the SSL certificate

This example replaces the existing SSL certificate for the specified HTTPS load balancer.

Sample Request

https://elasticloadbalancing.amazonaws.com/?Action=SetLoadBalancerListenerSSLCertificate &LoadBalancerName=my-loadbalancer &SSLCertificateId=arn:aws:iam::123456789012:server-certificate/my-new-server-cert &LoadBalancerPort=443 &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: