» azurerm_lb

Create a LoadBalancer Resource.

» Example Usage

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.
  • sku - (Optional) The SKU of the Azure Load Balancer. Accepted values are Basic and Standard. Defaults to Basic.

  • 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.
  • zones - (Optional) A collection containing the availability zone to allocate the IP in.

» Attributes Reference

The following attributes are exported:

  • id - The LoadBalancer ID.
  • private_ip_address - The first private IP address assigned to the load balancer in frontend_ip_configuration blocks, if any.
  • private_ip_addresses - The list of private IP address assigned to the load balancer in frontend_ip_configuration blocks, 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