Skip to main content

openstack_networking_network_v2

For your information

These instructions are a copy of the official OpenStack Terraform provider documentation in the Terraform Registry.

Use this data source to get the ID of an available OpenStack network.

Example Usage

data "openstack_networking_network_v2" "network" {
  name = "tf_test_network"
}

Argument Reference

  • region — (Optional) The region in which to obtain the V2 Neutron client.A Neutron client is needed to retrieve networks ids. If omitted, the region argument of the provider is used.

  • network_id — (Optional) The ID of the network.

  • name — (Optional) The name of the network.

  • description — (Optional) Human-readable description of the network.

  • status — (Optional) The status of the network.

  • external — (Optional) The external routing facility of the network.

  • matching_subnet_cidr — (Optional) The CIDR of a subnet within the network.

  • tenant_id — (Optional) The owner of the network.

  • availability_zone_hints — (Optional) The availability zone candidates for the network.

  • transparent_vlan — (Optional) The VLAN transparent attribute for thenetwork.

  • tags — (Optional) The list of network tags to filter.

  • mtu — (Optional) The network MTU to filter. Available, when Neutron net-mtu extension is enabled.

Attributes Reference

id is set to the ID of the found network. In addition, the following attributesare exported:

  • admin_state_up — The administrative state of the network.
  • name — See Argument Reference above.
  • description — See Argument Reference above.
  • region — See Argument Reference above.
  • external — See Argument Reference above.
  • shared — Specifies whether the network resource can be accessed by anytenant or not.
  • availability_zone_hints — The availability zone candidates for the network.
  • transparent_vlan — See Argument Reference above.
  • segments — An array of one or more provider segment objects.
  • mtu — See Argument Reference above.
  • dns_domain — The network DNS domain. Available, when Neutron DNS extensionis enabled
  • subnets — A list of subnet IDs belonging to the network.
  • all_tags — The set of string tags applied on the network.