terraform/website/source/docs/providers/aws/d/alb.html.markdown

49 lines
1.0 KiB
Markdown
Raw Normal View History

---
layout: "aws"
page_title: "AWS: aws_alb"
sidebar_current: "docs-aws-datasource-alb-x"
description: |-
Provides an Application Load Balancer data source.
---
# aws\_alb
Provides information about an Application Load Balancer.
This data source can prove useful when a module accepts an ALB as an input
variable and needs to, for example, determine the security groups associated
with it, etc.
## Example Usage
```hcl
variable "alb_arn" {
type = "string"
default = ""
}
variable "alb_name" {
type = "string"
default = ""
}
data "aws_alb" "test" {
arn = "${var.alb_arn}"
name = "${var.alb_arn}"
}
```
## Argument Reference
The following arguments are supported:
* `arn` - (Optional) The full ARN of the load balancer.
* `name` - (Optional) The unique name of the load balancer.
~> **NOTE**: When both `arn` and `name` are specified, `arn` takes precedence.
## Attributes Reference
See the [ALB Resource](/docs/providers/aws/r/alb.html) for details on the
returned attributes - they are identical.