github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/aws/d/alb.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_alb"
     4  sidebar_current: "docs-aws-datasource-alb-x"
     5  description: |-
     6    Provides an Application Load Balancer data source.
     7  ---
     8  
     9  # aws\_alb
    10  
    11  Provides information about an Application Load Balancer.
    12  
    13  This data source can prove useful when a module accepts an ALB as an input
    14  variable and needs to, for example, determine the security groups associated
    15  with it, etc.
    16  
    17  ## Example Usage
    18  
    19  ```hcl
    20  variable "alb_arn" {
    21    type    = "string"
    22    default = ""
    23  }
    24  
    25  variable "alb_name" {
    26    type    = "string"
    27    default = ""
    28  }
    29  
    30  data "aws_alb" "test" {
    31    arn  = "${var.alb_arn}"
    32    name = "${var.alb_arn}"
    33  }
    34  ```
    35  
    36  ## Argument Reference
    37  
    38  The following arguments are supported:
    39  
    40  * `arn` - (Optional) The full ARN of the load balancer.
    41  * `name` - (Optional) The unique name of the load balancer.
    42  
    43  ~> **NOTE**: When both `arn` and `name` are specified, `arn` takes precedence.
    44  
    45  ## Attributes Reference
    46  
    47  See the [ALB Resource](/docs/providers/aws/r/alb.html) for details on the
    48  returned attributes - they are identical.