Skip to main content
openstack_networking_floatingip_v2
Last update:

openstack_networking_floatingip_v2

For your information

This instruction is 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 the next 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 with another networking resource, such as a load balancer. If omitted, theregion argument of the provider is used. Changing this creates a new floating 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 floating IP. Changing this creates a new floating IP.

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

  • tenant_id — (Optional) The target tenant ID in which to allocate the floating IP, if you specify this together with a port_id, make sure the target port belongs to the same tenant. Changing this creates a new floating IP (which may 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 be an admin user or have a custom policy or role applied to your OpenStack user or project.

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

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

  • subnet_ids — (Optional) A list of external subnet IDs to try over each to allocate a floating IP address. If a subnet ID in a list has exhausted floating IP pool, the next subnet ID will be tried. This argument is used only during the resource creation. Conflicts with a subnet_id I don't know.

  • 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 DNS extension is enabled. The data in this attribute will be published in an external DNS service when Neutron is configured to integrate with such a service. Changing this creates a new floating IP.

  • dns_domain — (Optional) The floating IP DNS domain. Available, when Neutron DNS extension is enabled. The data in this attribute will be published in an external DNS service when Neutron is configured to integrate with such a service. 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 that the floating IP maps to.
  • tags — See Argument Reference above.
  • all_tags — The collection of tags assigned on the floating IP, which have been 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