github.com/minamijoyo/terraform@v0.7.8-0.20161029001309-18b3736ba44b/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    name = "my_router"
    18    external_gateway = "f67f0d72-0ddf-11e4-9d95-e1f29f417e2f"
    19  }
    20  ```
    21  
    22  ## Argument Reference
    23  
    24  The following arguments are supported:
    25  
    26  * `region` - (Required) The region in which to obtain the V2 networking client.
    27      A networking client is needed to create a router. If omitted, the
    28      `OS_REGION_NAME` environment variable is used. Changing this creates a new
    29      router.
    30  
    31  * `name` - (Optional) A unique name for the router. Changing this
    32      updates the `name` of an existing router.
    33  
    34  * `admin_state_up` - (Optional) Administrative up/down status for the router
    35      (must be "true" or "false" if provided). Changing this updates the
    36      `admin_state_up` of an existing router.
    37  
    38  * `distributed` - (Optional) Indicates whether or not to create a
    39      distributed router. The default policy setting in Neutron restricts
    40      usage of this property to administrative users only.
    41  
    42  * `external_gateway` - (Optional) The network UUID of an external gateway for
    43      the router. A router with an external gateway is required if any compute
    44      instances or load balancers will be using floating IPs. Changing this
    45      updates the `external_gateway` of an existing router.
    46  
    47  * `tenant_id` - (Optional) The owner of the floating IP. Required if admin wants
    48      to create a router for another tenant. Changing this creates a new router.
    49  
    50  * `value_specs` - (Optional) Map of additional driver-specific options.
    51  
    52  ## Attributes Reference
    53  
    54  The following attributes are exported:
    55  
    56  * `region` - See Argument Reference above.
    57  * `name` - See Argument Reference above.
    58  * `admin_state_up` - See Argument Reference above.
    59  * `external_gateway` - See Argument Reference above.
    60  * `tenant_id` - See Argument Reference above.
    61  * `value_specs` - See Argument Reference above.