# NetworkLoadBalancerAttributes

Properties to reference an existing load balancer.

- Source: [`aws-elasticloadbalancingv2/lib/nlb/network-load-balancer.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-elasticloadbalancingv2/lib/nlb/network-load-balancer.ts#L119)
- Type last changed: v2.112.0 · 1 Dec 2023

## 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

- `loadBalancerArn`: string (required) — ARN of the load balancer.

- `loadBalancerCanonicalHostedZoneId`: string — The canonical hosted zone ID of this load balancer.

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

- `loadBalancerDnsName`: string — The DNS name of this load balancer.

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

- `loadBalancerSecurityGroups`: string[] — Security groups to associate with this load balancer.

  **Default:** No security groups associated with the load balancer.

- `vpc`: [IVpc](/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.IVpc.html) — The VPC to associate with the load balancer.

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