LoadBalancerListener¶

class aws_cdk.aws_elasticloadbalancing.LoadBalancerListener(*, external_port, allow_connections_from=None, external_protocol=None, internal_port=None, internal_protocol=None, policy_names=None, ssl_certificate_arn=None, ssl_certificate_id=None)¶

Bases: object

Add a backend to the load balancer.

Parameters

external_port (Union[int, float]) – External listening port.
allow_connections_from (Optional[Sequence[IConnectable]]) – Allow connections to the load balancer from the given set of connection peers. By default, connections will be allowed from anywhere. Set this to an empty list to deny connections, or supply a custom list of peers to allow connections from (IP ranges or security groups). Default: Anywhere
external_protocol (Optional[LoadBalancingProtocol]) – What public protocol to use for load balancing. Either ‘tcp’, ‘ssl’, ‘http’ or ‘https’. May be omitted if the external port is either 80 or 443.
internal_port (Union[int, float, None]) – Instance listening port. Same as the externalPort if not specified. Default: externalPort
internal_protocol (Optional[LoadBalancingProtocol]) – What public protocol to use for load balancing. Either ‘tcp’, ‘ssl’, ‘http’ or ‘https’. May be omitted if the internal port is either 80 or 443. The instance protocol is ‘tcp’ if the front-end protocol is ‘tcp’ or ‘ssl’, the instance protocol is ‘http’ if the front-end protocol is ‘https’.
policy_names (Optional[Sequence[str]]) – SSL policy names.
ssl_certificate_arn (Optional[str]) – the ARN of the SSL certificate. Default: - none
ssl_certificate_id (Optional[str]) – (deprecated) the ARN of the SSL certificate.

ExampleMetadata

infused

Example:

# vpc: ec2.IVpc

# my_auto_scaling_group: autoscaling.AutoScalingGroup

lb = elb.LoadBalancer(self, "LB",
    vpc=vpc,
    internet_facing=True,
    health_check=elb.HealthCheck(
        port=80
    )
)
lb.add_target(my_auto_scaling_group)
lb.add_listener(
    external_port=80
)

Attributes

allow_connections_from¶

Allow connections to the load balancer from the given set of connection peers.

By default, connections will be allowed from anywhere. Set this to an empty list to deny connections, or supply a custom list of peers to allow connections from (IP ranges or security groups).

Default: Anywhere
Return type: Optional[List[IConnectable]]

external_port¶

External listening port.

Return type: Union[int, float]

external_protocol¶

What public protocol to use for load balancing.

Either ‘tcp’, ‘ssl’, ‘http’ or ‘https’.

May be omitted if the external port is either 80 or 443.

Return type: Optional[LoadBalancingProtocol]

internal_port¶

Instance listening port.

Same as the externalPort if not specified.

Default: externalPort
Return type: Union[int, float, None]

internal_protocol¶

What public protocol to use for load balancing.

Either ‘tcp’, ‘ssl’, ‘http’ or ‘https’.

May be omitted if the internal port is either 80 or 443.

The instance protocol is ‘tcp’ if the front-end protocol is ‘tcp’ or ‘ssl’, the instance protocol is ‘http’ if the front-end protocol is ‘https’.

Return type: Optional[LoadBalancingProtocol]

policy_names¶

SSL policy names.

Return type: Optional[List[str]]

ssl_certificate_arn¶

the ARN of the SSL certificate.

Default

none

Return type

Optional[str]

ssl_certificate_id¶

(deprecated) the ARN of the SSL certificate.

Deprecated

use sslCertificateArn instead

Stability

deprecated

Return type

Optional[str]