55 lines
1.3 KiB
Markdown
55 lines
1.3 KiB
Markdown
|
---
|
||
|
|
layout: "aws"
|
||
|
|
page_title: "AWS: aws_elb"
|
||
|
|
sidebar_current: "docs-aws-resource-elb"
|
||
|
|
---
|
||
|
|
|
||
|
|
# aws\_elb
|
||
|
|
|
||
|
|
Provides an Elastic Load Balancer resource.
|
||
|
|
|
||
|
|
## Example Usage
|
||
|
|
|
||
|
|
```
|
||
|
|
# Create a new load balancer
|
||
|
|
resource "aws_elb" "bar" {
|
||
|
|
name = "foobar-terraform-elb"
|
||
|
|
availability_zones = ["us-west-2a", "us-west-2b", "us-west-2c"]
|
||
|
|
|
||
|
|
listener {
|
||
|
|
instance_port = 8000
|
||
|
|
instance_protocol = "http"
|
||
|
|
lb_port = 80
|
||
|
|
lb_protocol = "http"
|
||
|
|
}
|
||
|
|
|
||
|
|
instances = ["${aws_instance.foo.id}"]
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Argument Reference
|
||
|
|
|
||
|
|
The following arguments are supported:
|
||
|
|
|
||
|
|
* `name` - (Required) The name of the ELB
|
||
|
|
* `availability_zones` - (Optional) The AZ's to serve traffic in.
|
||
|
|
* `instances` - (Optional) A list of instance ids to place in the ELB pool.
|
||
|
|
* `listener` - (Required) A list of listener blocks. Listeners documented below.
|
||
|
|
|
||
|
|
Listeners support the following:
|
||
|
|
|
||
|
|
* `instance_port` - (Required) The port on the instance to route to
|
||
|
|
* `instance_protocol` - (Required) The the protocol to use to the instance.
|
||
|
|
* `lb_port` - (Required) The port to listen on for the load balancer
|
||
|
|
* `lb_protocol` - (Required) The protocol to listen on.
|
||
|
|
|
||
|
|
## Attributes Reference
|
||
|
|
|
||
|
|
The following attributes are exported:
|
||
|
|
|
||
|
|
* `id` - The name of the ELB
|
||
|
|
* `name` - The name of the ELB
|
||
|
|
* `dns_name` - The DNS name of the ELB
|
||
|
|
* `instances` - The list of instances in the ELB
|
||
|
|
|