terraform/website/source/docs/providers/openstack/r/lb_loadbalancer_v2.html.markdown

---
layout: "openstack"
page_title: "OpenStack: openstack_lb_loadbalancer_v2"
sidebar_current: "docs-openstack-resource-lb-loadbalancer-v2"
description: |-
  Manages a V2 loadbalancer resource within OpenStack.
---

# openstack\_lb\_loadbalancer\_v2

Manages a V2 loadbalancer resource within OpenStack.

## Example Usage

```
resource "openstack_lb_loadbalancer_v2" "lb_1" {
  vip_subnet_id = "d9415786-5f1a-428b-b35f-2f1523e146d2"
}
```

## Argument Reference

The following arguments are supported:

* `region` - (Required) The region in which to obtain the V2 Networking client.
    A Networking client is needed to create an LB member. If omitted, the
    `OS_REGION_NAME` environment variable is used. Changing this creates a new
    LB member.

* `vip_subnet_id` - (Required) The network on which to allocate the 
    Loadbalancer's address. A tenant can only create Loadbalancers on networks
    authorized by policy (e.g. networks that belong to them or networks that
    are shared).  Changing this creates a new loadbalancer.

* `name` - (Optional) Human-readable name for the Loadbalancer. Does not have
    to be unique.

* `description` - (Optional) Human-readable description for the Loadbalancer.

* `tenant_id` - (Optional) Required for admins. The UUID of the tenant who owns
    the Loadbalancer.  Only administrative users can specify a tenant UUID
    other than their own.  Changing this creates a new loadbalancer.
    
* `vip_address` - (Optional) The ip address of the load balancer.
    Changing this creates a new loadbalancer.
    
* `admin_state_up` - (Optional) The administrative state of the Loadbalancer.
    A valid value is true (UP) or false (DOWN).
    
* `flavor` - (Optional) The UUID of a flavor. Changing this creates a new
    loadbalancer.

* `provider` - (Optional) The name of the provider. Changing this creates a new
    loadbalancer.

## Attributes Reference

The following attributes are exported:

* `region` - See Argument Reference above.
* `vip_subnet_id` - See Argument Reference above.
* `name` - See Argument Reference above.
* `description` - See Argument Reference above.
* `tenant_id` - See Argument Reference above.
* `vip_address` - See Argument Reference above.
* `admin_state_up` - See Argument Reference above.
* `flavor` - See Argument Reference above.
* `provider` - See Argument Reference above.