Namespace Amazon.CDK.AWS.ElasticLoadBalancing

Amazon Elastic Load Balancing Construct Library

---

AWS CDK v1 has reached End-of-Support on 2023-06-01.
This package is no longer being updated, and users should migrate to AWS CDK v2.

For more information on how to migrate, see the Migrating to AWS CDK v2 guide.

---

The @aws-cdk/aws-elasticloadbalancing package provides constructs for configuring classic load balancers.

Configuring a Load Balancer

Load balancers send traffic to one or more AutoScalingGroups. Create a load balancer, set up listeners and a health check, and supply the fleet(s) you want to load balance to in the targets property.

IVpc vpc;

AutoScalingGroup myAutoScalingGroup;

var lb = new LoadBalancer(this, "LB", new LoadBalancerProps {
    Vpc = vpc,
    InternetFacing = true,
    HealthCheck = new HealthCheck {
        Port = 80
    }
});
lb.AddTarget(myAutoScalingGroup);
lb.AddListener(new LoadBalancerListener {
    ExternalPort = 80
});

The load balancer allows all connections by default. If you want to change that, pass the allowConnectionsFrom property while setting up the listener:

SecurityGroup mySecurityGroup;
LoadBalancer lb;

lb.AddListener(new LoadBalancerListener {
    ExternalPort = 80,
    AllowConnectionsFrom = new [] { mySecurityGroup }
});

Classes

CfnLoadBalancer	A CloudFormation AWS::ElasticLoadBalancing::LoadBalancer.
CfnLoadBalancer.AccessLoggingPolicyProperty	Specifies where and how access logs are stored for your Classic Load Balancer.
CfnLoadBalancer.AppCookieStickinessPolicyProperty	Specifies a policy for application-controlled session stickiness for your Classic Load Balancer.
CfnLoadBalancer.ConnectionDrainingPolicyProperty	Specifies the connection draining settings for your Classic Load Balancer.
CfnLoadBalancer.ConnectionSettingsProperty	Specifies the idle timeout value for your Classic Load Balancer.
CfnLoadBalancer.HealthCheckProperty	Specifies health check settings for your Classic Load Balancer.
CfnLoadBalancer.LBCookieStickinessPolicyProperty	Specifies a policy for duration-based session stickiness for your Classic Load Balancer.
CfnLoadBalancer.ListenersProperty	Specifies a listener for your Classic Load Balancer.
CfnLoadBalancer.PoliciesProperty	Specifies policies for your Classic Load Balancer.
CfnLoadBalancerProps	Properties for defining a CfnLoadBalancer.
HealthCheck	Describe the health check to a load balancer.
ListenerPort	Reference to a listener's port just created.
LoadBalancer	A load balancer with a single listener.
LoadBalancerListener	Add a backend to the load balancer.
LoadBalancerProps	Construction properties for a LoadBalancer.
LoadBalancingProtocol

Interfaces

CfnLoadBalancer.IAccessLoggingPolicyProperty	Specifies where and how access logs are stored for your Classic Load Balancer.
CfnLoadBalancer.IAppCookieStickinessPolicyProperty	Specifies a policy for application-controlled session stickiness for your Classic Load Balancer.
CfnLoadBalancer.IConnectionDrainingPolicyProperty	Specifies the connection draining settings for your Classic Load Balancer.
CfnLoadBalancer.IConnectionSettingsProperty	Specifies the idle timeout value for your Classic Load Balancer.
CfnLoadBalancer.IHealthCheckProperty	Specifies health check settings for your Classic Load Balancer.
CfnLoadBalancer.ILBCookieStickinessPolicyProperty	Specifies a policy for duration-based session stickiness for your Classic Load Balancer.
CfnLoadBalancer.IListenersProperty	Specifies a listener for your Classic Load Balancer.
CfnLoadBalancer.IPoliciesProperty	Specifies policies for your Classic Load Balancer.
ICfnLoadBalancerProps	Properties for defining a CfnLoadBalancer.
IHealthCheck	Describe the health check to a load balancer.
ILoadBalancerListener	Add a backend to the load balancer.
ILoadBalancerProps	Construction properties for a LoadBalancer.
ILoadBalancerTarget	Interface that is going to be implemented by constructs that you can load balance to.