Skip to main content

openstack_networking_subnet_v2

Last update:
For your information

This instruction is a copy of the official documentation for the OpenStack Terraform provider 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 from which to obtain the V2 Neutron client. A Neutron client is required 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) Whether DHCP is enabled for the subnet.

  • 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 (4 or 6).

  • gateway_ip - (Optional) The IP address of the subnet 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 values are dhcpv6-stateful, dhcpv6-stateless, or slaac.

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

  • tags - (Optional) A list of subnet tags for filtering.

Attributes Reference

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

  • allocation_pools - Allocation pools for the subnet.
  • enable_dhcp - Whether DHCP is enabled for the subnet.
  • dns_nameservers - DNS nameservers for the subnet.
  • service_types - Service types for the subnet.
  • host_routes - Host routes for the subnet.
  • region - See the Argument Reference above.
  • all_tags - A set of string tags applied to the subnet.