---
title: "openstack_networking_router_v2"
description: ""
sidebar_position: 11
---

# openstack\_networking\_router\_v2

:::info

Эта инструкция — адаптированная копия официальной документации OpenStack Terraform-провайдера в [Terraform Registry](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs).

:::

Manages a V2 router resource within OpenStack.

## Example Usage \{#example-usage}

```hcl
data "openstack_networking_network_v2" "external_network_1" {
  external = true
}

resource "openstack_networking_router_v2" "router_1" {
  name                = "my_router"
  admin_state_up      = true
  external_network_id = data.openstack_networking_network_v2.external_network_1.id
}
```

## Argument Reference \{#argument-reference}

The following arguments are supported:

* `region` - (Optional) The region in which to obtain the V2 networking client.
  A networking client is needed to create a router. If omitted, the
  `region` argument of the provider is used. Changing this creates a new
  router.

* `name` - (Optional) A unique name for the router. Changing this
  updates the `name` of an existing router.

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

* `admin_state_up` - (Optional) Administrative up/down status for the router
  (must be "true" or "false" if provided). Changing this updates the
  `admin_state_up` of an existing router.

* `distributed` - (Optional) Indicates whether or not to create a
  distributed router. The default policy setting in Neutron restricts
  usage of this property to administrative users only.

* `external_gateway` - (**Deprecated** - use `external_network_id` instead) The
  network UUID of an external gateway for the router. A router with an
  external gateway is required if any compute instances or load balancers
  will be using floating IPs. Changing this updates the external gateway
  of an existing router.

* `external_network_id` - (Optional) The network UUID of an external gateway
  for the router. A router with an external gateway is required if any
  compute instances or load balancers will be using floating IPs.
  The external network is a service network that cannot be changed and must be assigned via
  the [openstack\_networking\_network\_v2](/terraform/openstack-provider-reference/networking-neutron/data-sources/openstack_networking_network_v2/) data source.

* `enable_snat` - (Optional) Enable Source NAT for the router. Valid values are
  "true" or "false". An `external_network_id` has to be set in order to
  set this property. Changing this updates the `enable_snat` of the router.
  Setting this value **requires** an **ext-gw-mode** extension to be enabled
  in OpenStack Neutron.

* `tenant_id` - (Optional) The owner of the floating IP. Required if admin wants
  to create a router for another tenant. Changing this creates a new router.

* `value_specs` - (Optional) Map of additional driver-specific options.

* `tags` - (Optional) A set of string tags for the router.

* `vendor_options` - (Optional) Map of additional vendor-specific options.
  Supported options are described below.

* `availability_zone_hints` -  (Optional) An availability zone is used to make
  network resources highly available. Used for resources with high availability
  so that they are scheduled on different availability zones. Changing this
  creates a new router.

The `vendor_options` block supports:

* `set_router_gateway_after_create` - (Optional) Boolean to control whether
  the Router gateway is assigned during creation or updated after creation.

## Attributes Reference \{#attributes-reference}

The following attributes are exported:

* `id` - ID of the router.
* `region` - See Argument Reference above.
* `name` - See Argument Reference above.
* `description` - See Argument Reference above.
* `admin_state_up` - See Argument Reference above.
* `external_gateway` - See Argument Reference above.
* `external_network_id` - See Argument Reference above.
* `enable_snat` - See Argument Reference above.
* `external_fixed_ip` - An external fixed IP for the router. Assigned automatically when the `external_network_id` argument is specified.
* `tenant_id` - See Argument Reference above.
* `value_specs` - See Argument Reference above.
* `availability_zone_hints` - See Argument Reference above.
* `tags` - See Argument Reference above.
* `all_tags` - The collection of tags assigned on the router, which have been
  explicitly and implicitly added.

## Import \{#import}

Routers can be imported using the `id`, e.g.

```bash
$ terraform import openstack_networking_router_v2.router_1 014395cd-89fc-4c9b-96b7-13d1ee79dad2
```