github.com/adrian-bl/terraform@v0.7.0-rc2.0.20160705220747-de0a34fc3517/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  * `distributed` - (Optional) Indicates whether or not to create a
    40      distributed router. The default policy setting in Neutron restricts
    41      usage of this property to administrative users only.
    42  
    43  * `external_gateway` - (Optional) The network UUID of an external gateway for
    44      the router. A router with an external gateway is required if any compute
    45      instances or load balancers will be using floating IPs. Changing this
    46      updates the `external_gateway` of an existing router.
    47  
    48  * `tenant_id` - (Optional) The owner of the floating IP. Required if admin wants
    49      to create a router for another tenant. Changing this creates a new router.
    50  
    51  * `value_specs` - (Optional) Map of additional driver-specific options.
    52  
    53  ## Attributes Reference
    54  
    55  The following attributes are exported:
    56  
    57  * `region` - See Argument Reference above.
    58  * `name` - See Argument Reference above.
    59  * `admin_state_up` - See Argument Reference above.
    60  * `external_gateway` - See Argument Reference above.
    61  * `tenant_id` - See Argument Reference above.
    62  * `value_specs` - See Argument Reference above.