github.com/hobbeswalsh/terraform@v0.3.7-0.20150619183303-ad17cf55a0fa/website/source/docs/providers/openstack/r/networking_router_v2.html.markdown (about)

     1  ---
     2  layout: "openstack"
     3  page_title: "OpenStack: openstack_networking_router_v2"
     4  sidebar_current: "docs-openstack-resource-networking-router-v2"
     5  description: |-
     6    Manages a V2 router resource within OpenStack.
     7  ---
     8  
     9  # openstack\_networking\_router_v2
    10  
    11  Manages a V2 router resource within OpenStack.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "openstack_networking_router_v2" "router_1" {
    17    region = ""
    18    name = "my_router"
    19    external_gateway = "f67f0d72-0ddf-11e4-9d95-e1f29f417e2f"
    20  }
    21  ```
    22  
    23  ## Argument Reference
    24  
    25  The following arguments are supported:
    26  
    27  * `region` - (Required) The region in which to obtain the V2 networking client.
    28      A networking client is needed to create a router. If omitted, the
    29      `OS_REGION_NAME` environment variable is used. Changing this creates a new
    30      router.
    31  
    32  * `name` - (Optional) A unique name for the router. Changing this
    33      updates the `name` of an existing router.
    34  
    35  * `admin_state_up` - (Optional) Administrative up/down status for the router
    36      (must be "true" or "false" if provided). Changing this updates the
    37      `admin_state_up` of an existing router.
    38  
    39  * `external_gateway` - (Optional) The network UUID of an external gateway for
    40      the router. A router with an external gateway is required if any compute
    41      instances or load balancers will be using floating IPs. Changing this
    42      updates the `external_gateway` of an existing router.
    43  
    44  * `tenant_id` - (Optional) The owner of the floating IP. Required if admin wants
    45      to create a router for another tenant. Changing this creates a new router.
    46  
    47  ## Attributes Reference
    48  
    49  The following attributes are exported:
    50  
    51  * `region` - See Argument Reference above.
    52  * `name` - See Argument Reference above.
    53  * `admin_state_up` - See Argument Reference above.
    54  * `external_gateway` - See Argument Reference above.
    55  * `tenant_id` - See Argument Reference above.