Skip to main content

openstack_networking_subnet_v2

Last update:
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 subnet.

Example Usage

data "openstack_networking_subnet_v2" "subnet_1" {
  name = "subnet_1"
}

Argument Reference

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

  • name - (Optional) The name of the subnet.

  • description - (Optional) Human-readable description of the subnet.

  • dhcp_enabled - (Optional) If the subnet has DHCP enabled.

  • network_id - (Optional) The ID of the network the subnet belongs to.

  • tenant_id - (Optional) The owner of the subnet.

  • ip_version - (Optional) The IP version of the subnet (either 4 or 6).

  • gateway_ip - (Optional) The IP of the subnet's gateway.

  • cidr - (Optional) The CIDR of the subnet.

  • subnet_id - (Optional) The ID of the subnet.

  • ipv6_address_mode - (Optional) The IPv6 address mode. Valid values are dhcpv6-stateful, dhcpv6-stateless, or slaac.

  • ipv6_ra_mode. - (Optional) The IPv6 Router Advertisement mode. Valid valuesare dhcpv6-stateful, dhcpv6-stateless, or slaac.

  • subnetpool_id - (Optional) The ID of the subnetpool associated with the subnet.

  • tags - (Optional) The list of subnet tags to filter.

Attributes Reference

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

  • allocation_pools - Allocation pools of the subnet.
  • enable_dhcp - Whether the subnet has DHCP enabled or not.
  • dns_nameservers - DNS Nameservers of the subnet.
  • service_types - Service types of the subnet.
  • host_routes - Host Routes of the subnet.
  • region - See Argument Reference above.
  • all_tags - A set of string tags applied on the subnet.