Skip to main content
openstack_networking_floatingip_v2
Last update:

openstack_networking_floatingip_v2

For your information

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

Manages a V2 floating IP resource within OpenStack Neutron (networking) that can be used for load balancers.These are similar to Nova (compute) floating IP resources, but only compute floating IPs can be used with compute instances.

Example Usage⁠

Simple floating IP allocation⁠

resource "openstack_networking_floatingip_v2" "floatip_1" {
  pool = "external-network"
}

Floating IP allocation using a list of subnets⁠

If one of the subnets in a list has an exhausted pool, terraform will try thenext subnet ID from the list.

data "openstack_networking_network_v2" "ext_network" {
  name = "external-network"
}

data "openstack_networking_subnet_ids_v2" "ext_subnets" {
  network_id = data.openstack_networking_network_v2.ext_network.id
}

resource "openstack_networking_floatingip_v2" "floatip_1" {
  pool       = data.openstack_networking_network_v2.ext_network.name
  subnet_ids = data.openstack_networking_subnet_ids_v2.ext_subnets.ids
}

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 floating IP that can be used withanother networking resource, such as a load balancer. If omitted, the region argument of the provider is used. Changing this creates a newfloating IP (which may or may not have a different address).

  • description — (Optional) Human-readable description for the floating IP.

  • pool — (Required) The name of the pool from which to obtain the floatingIP. Changing this creates a new floating IP.

  • port_id — (Optional) ID of an existing port with at least one IP address toassociate with this floating IP.

  • tenant_id — (Optional) The target tenant ID in which to allocate the floatingIP, if you specify this together with a port_id, make sure the target portbelongs to the same tenant. Changing this creates a new floating IP (whichmay or may not have a different address)

  • address — (Optional) The actual/specific floating IP to obtain. By default,non-admin users are not able to specify a floating IP, so you must either bean admin user or have had a custom policy or role applied to your OpenStackuser or project.

  • fixed_ip — Fixed IP of the port to associate with this floating IP. Required ifthe port has multiple fixed IPs.

  • subnet_id — (Optional) The subnet ID of the floating IP pool. Specify this ifthe floating IP network has multiple subnets.

  • subnet_ids — (Optional) A list of external subnet IDs to try over each toallocate a floating IP address. If a subnet ID in a list has exhaustedfloating IP pool, the next subnet ID will be tried. This argument is used onlyduring the resource creation. Conflicts with a subnet_id argument.

  • value_specs — (Optional) Map of additional options.

  • tags — (Optional) A set of string tags for the floating IP.

  • dns_name — (Optional) The floating IP DNS name. Available, when Neutron DNSextension is enabled. The data in this attribute will be published in anexternal DNS service when Neutron is configured to integrate with such aservice. Changing this creates a new floating IP.

  • dns_domain — (Optional) The floating IP DNS domain. Available, when NeutronDNS extension is enabled. The data in this attribute will be published in anexternal DNS service when Neutron is configured to integrate with such aservice. Changing this creates a new floating IP.

Attributes Reference⁠

The following attributes are exported:

  • region — See Argument Reference above.
  • description — See Argument Reference above.
  • pool — See Argument Reference above.
  • address — The actual floating IP address itself.
  • port_id — ID of associated port.
  • tenant_id — the ID of the tenant in which to create the floating IP.
  • fixed_ip — The fixed IP which the floating IP maps to.
  • tags — See Argument Reference above.
  • all_tags — The collection of tags assigned on the floating IP, which havebeen explicitly and implicitly added.
  • dns_name — See Argument Reference above.
  • dns_domain — See Argument Reference above.

Import⁠

Floating IPs can be imported using the id, e.g.

$ terraform import openstack_networking_floatingip_v2.floatip_1 2c7f39f3-702b-48d1-940c-b50384177ee1