LoadBalancerProps Struct
Construction properties for a LoadBalancer.
| Source | aws-elasticloadbalancing/lib/load-balancer.ts |
|---|
Example
ts
declare const cluster: ecs.Cluster;
declare const taskDefinition: ecs.TaskDefinition;
declare const vpc: ec2.Vpc;
const service = new ecs.Ec2Service(this, 'Service', { cluster, taskDefinition, minHealthyPercent: 100 });
const lb = new elb.LoadBalancer(this, 'LB', { vpc });
lb.addListener({ externalPort: 80 });
lb.addTarget(service);
python
# cluster: ecs.Cluster
# task_definition: ecs.TaskDefinition
# vpc: ec2.Vpc
service = ecs.Ec2Service(self, "Service", cluster=cluster, task_definition=task_definition, min_healthy_percent=100)
lb = elb.LoadBalancer(self, "LB", vpc=vpc)
lb.add_listener(external_port=80)
lb.add_target(service)
java
Cluster cluster;
TaskDefinition taskDefinition;
Vpc vpc;
Ec2Service service = Ec2Service.Builder.create(this, "Service").cluster(cluster).taskDefinition(taskDefinition).minHealthyPercent(100).build();
LoadBalancer lb = LoadBalancer.Builder.create(this, "LB").vpc(vpc).build();
lb.addListener(LoadBalancerListener.builder().externalPort(80).build());
lb.addTarget(service);
csharp
// Install: dotnet add package Amazon.CDK.Lib
Cluster cluster;
TaskDefinition taskDefinition;
Vpc vpc;
var service = new Ec2Service(this, "Service", new Ec2ServiceProps { Cluster = cluster, TaskDefinition = taskDefinition, MinHealthyPercent = 100 });
var lb = new LoadBalancer(this, "LB", new LoadBalancerProps { Vpc = vpc });
lb.AddListener(new LoadBalancerListener { ExternalPort = 80 });
lb.AddTarget(service);
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var cluster Cluster
var taskDefinition TaskDefinition
var vpc Vpc
service := ecs.NewEc2Service(this, jsii.String("Service"), &Ec2ServiceProps{
Cluster: Cluster,
TaskDefinition: TaskDefinition,
MinHealthyPercent: jsii.Number(100),
})
lb := elb.NewLoadBalancer(this, jsii.String("LB"), &LoadBalancerProps{
Vpc: Vpc,
})
lb.AddListener(&LoadBalancerListener{
ExternalPort: jsii.Number(80),
})
lb.AddTarget(service)
Properties
accessLoggingPolicyoptionalCfnLoadBalancer.access_logging_policyoptionalAccessLoggingPolicyPropertyaccessLoggingPolicyoptionalAccessLoggingPolicyPropertyAccessLoggingPolicyoptionalAccessLoggingPolicyPropertyAccessLoggingPolicyoptionalAccessLoggingPolicyProperty = disabled #Enable Loadbalancer access logs Can be used to avoid manual work as aws console Required S3 bucket name , enabled flag Can add interval for pushing log Can set bucket prefix in order to provide folder name inside bucket.
crossZoneoptionalbooleancross_zoneoptionalboolcrossZoneoptionalBooleanCrossZoneoptionalboolCrossZoneoptional*bool = true #Whether cross zone load balancing is enabled.
This controls whether the load balancer evenly distributes requests across each availability zone
healthCheckoptionalHealthCheckhealth_checkoptionalHealthCheckhealthCheckoptionalHealthCheckHealthCheckoptionalHealthCheckHealthCheckoptionalHealthCheck = None. #Health check settings for the load balancing targets.
Not required but recommended.
internetFacingoptionalbooleaninternet_facingoptionalboolinternetFacingoptionalBooleanInternetFacingoptionalboolInternetFacingoptional*bool = false #Whether this is an internet-facing Load Balancer.
This controls whether the LB has a public IP address assigned. It does not open up the Load Balancer's security groups to public internet access.
listenersoptionalLoadBalancerListener[]listenersoptionaltyping.List[LoadBalancerListener]listenersoptionalList<LoadBalancerListener>ListenersoptionalLoadBalancerListener[]Listenersoptional*[]LoadBalancerListener #What listeners to set up for the load balancer.
Can also be added by .addListener()
subnetSelectionoptionalSubnetSelectionsubnet_selectionoptionalSubnetSelectionsubnetSelectionoptionalSubnetSelectionSubnetSelectionoptionalSubnetSelectionSubnetSelectionoptionalSubnetSelection #Which subnets to deploy the load balancer.
Default: Public subnets if internetFacing, Private subnets otherwise
Can be used to define a specific set of subnets to deploy the load balancer to. Useful multiple public or private subnets are covering the same availability zone.
targetsoptionalILoadBalancerTarget[]targetsoptionaltyping.List[ILoadBalancerTarget]targetsoptionalList<ILoadBalancerTarget>TargetsoptionalILoadBalancerTarget[]Targetsoptional*[]ILoadBalancerTarget = None. #What targets to load balance to.
Can also be added by .addTarget()