mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-03-13 19:01:09 -04:00
73 lines
2.4 KiB
Markdown
73 lines
2.4 KiB
Markdown
---
|
|
layout: "azurerm"
|
|
page_title: "Azure Resource Manager: azurerm_lb"
|
|
sidebar_current: "docs-azurerm-resource-loadbalancer"
|
|
description: |-
|
|
Create a LoadBalancer Resource.
|
|
---
|
|
|
|
# azurerm\_lb
|
|
|
|
Create a LoadBalancer Resource.
|
|
|
|
## Example Usage
|
|
|
|
```hcl
|
|
resource "azurerm_resource_group" "test" {
|
|
name = "LoadBalancerRG"
|
|
location = "West US"
|
|
}
|
|
|
|
resource "azurerm_public_ip" "test" {
|
|
name = "PublicIPForLB"
|
|
location = "West US"
|
|
resource_group_name = "${azurerm_resource_group.test.name}"
|
|
public_ip_address_allocation = "static"
|
|
}
|
|
|
|
resource "azurerm_lb" "test" {
|
|
name = "TestLoadBalancer"
|
|
location = "West US"
|
|
resource_group_name = "${azurerm_resource_group.test.name}"
|
|
|
|
frontend_ip_configuration {
|
|
name = "PublicIPAddress"
|
|
public_ip_address_id = "${azurerm_public_ip.test.id}"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Argument Reference
|
|
|
|
The following arguments are supported:
|
|
|
|
* `name` - (Required) Specifies the name of the LoadBalancer.
|
|
* `resource_group_name` - (Required) The name of the resource group in which to create the LoadBalancer.
|
|
* `location` - (Required) Specifies the supported Azure location where the resource exists.
|
|
* `frontend_ip_configuration` - (Optional) A frontend ip configuration block as documented below.
|
|
* `tags` - (Optional) A mapping of tags to assign to the resource.
|
|
|
|
`frontend_ip_configuration` supports the following:
|
|
|
|
* `name` - (Required) Specifies the name of the frontend ip configuration.
|
|
* `subnet_id` - (Optional) Reference to subnet associated with the IP Configuration.
|
|
* `private_ip_address` - (Optional) Private IP Address to assign to the Load Balancer. The last one and first four IPs in any range are reserved and cannot be manually assigned.
|
|
* `private_ip_address_allocation` - (Optional) Defines how a private IP address is assigned. Options are Static or Dynamic.
|
|
* `public_ip_address_id` - (Optional) Reference to Public IP address to be associated with the Load Balancer.
|
|
|
|
## Attributes Reference
|
|
|
|
The following attributes are exported:
|
|
|
|
* `id` - The LoadBalancer ID.
|
|
* `private_ip_address` - The private IP address assigned to the load balancer, if any.
|
|
|
|
## Import
|
|
|
|
Load Balancers can be imported using the `resource id`, e.g.
|
|
|
|
```
|
|
terraform import azurerm_lb.test /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Network/loadBalancers/lb1
|
|
```
|
|
|