Skip to content
v2.274.0

NetworkLoadBalancerAttributes Struct ​

Properties to reference an existing load balancer.

Example ​

ts
// Create an Accelerator
const accelerator = new globalaccelerator.Accelerator(this, 'Accelerator');

// Create a Listener
const listener = accelerator.addListener('Listener', {
  portRanges: [
    { fromPort: 80 },
    { fromPort: 443 },
  ],
});

// Import the Load Balancers
const nlb1 = elbv2.NetworkLoadBalancer.fromNetworkLoadBalancerAttributes(this, 'NLB1', {
  loadBalancerArn: 'arn:aws:elasticloadbalancing:us-west-2:111111111111:loadbalancer/app/my-load-balancer1/e16bef66805b',
});
const nlb2 = elbv2.NetworkLoadBalancer.fromNetworkLoadBalancerAttributes(this, 'NLB2', {
  loadBalancerArn: 'arn:aws:elasticloadbalancing:ap-south-1:111111111111:loadbalancer/app/my-load-balancer2/5513dc2ea8a1',
});

// Add one EndpointGroup for each Region we are targeting
listener.addEndpointGroup('Group1', {
  endpoints: [new ga_endpoints.NetworkLoadBalancerEndpoint(nlb1)],
});
listener.addEndpointGroup('Group2', {
  // Imported load balancers automatically calculate their Region from the ARN.
  // If you are load balancing to other resources, you must also pass a `region`
  // parameter here.
  endpoints: [new ga_endpoints.NetworkLoadBalancerEndpoint(nlb2)],
});

Properties ​

loadBalancerArnstringload_balancer_arnstrloadBalancerArnStringLoadBalancerArnstringLoadBalancerArn*stringrequired#
ARN of the load balancer.
loadBalancerCanonicalHostedZoneIdoptionalstringload_balancer_canonical_hosted_zone_idoptionalstrloadBalancerCanonicalHostedZoneIdoptionalStringLoadBalancerCanonicalHostedZoneIdoptionalstringLoadBalancerCanonicalHostedZoneIdoptional*string#
The canonical hosted zone ID of this load balancer.

Default: When not provided, LB cannot be used as Route53 Alias target.

loadBalancerDnsNameoptionalstringload_balancer_dns_nameoptionalstrloadBalancerDnsNameoptionalStringLoadBalancerDnsNameoptionalstringLoadBalancerDnsNameoptional*string#
The DNS name of this load balancer.

Default: When not provided, LB cannot be used as Route53 Alias target.

loadBalancerSecurityGroupsoptionalstring[]load_balancer_security_groupsoptionaltyping.List[str]loadBalancerSecurityGroupsoptionalList<String>LoadBalancerSecurityGroupsoptionalstring[]LoadBalancerSecurityGroupsoptional*[]*string#
Security groups to associate with this load balancer.

Default: No security groups associated with the load balancer.

vpcoptionalIVpcvpcoptionalIVpcvpcoptionalIVpcVpcoptionalIVpcVpcoptionalIVpc#
The VPC to associate with the load balancer.

Default: When not provided, listeners cannot be created on imported load balancers.