Skip to main content

openstack_networking_port_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 port.

Example Usage⁠

data "openstack_networking_port_v2" "port_1" {
  name = "port_1"
}

Argument Reference⁠

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

  • project_id — (Optional) The owner of the port.

  • port_id — (Optional) The ID of the port.

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

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

  • admin_state_up — (Optional) The administrative state of the port.

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

  • device_owner — (Optional) The device owner of the port.

  • mac_address — (Optional) The MAC address of the port.

  • device_id — (Optional) The ID of the device the port belongs to.

  • fixed_ip — (Optional) The port IP address filter.

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

  • security_group_ids — (Optional) The list of port security group IDs to filter.

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

  • dns_name — (Optional) The port DNS name to filter. Available, when NeutronDNS extension is enabled.

Attributes Reference⁠

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

  • region — See Argument Reference above.

  • project_id — See Argument Reference above.

  • port_id — See Argument Reference above.

  • name — See Argument Reference above.

  • description — See Argument Reference above.

  • admin_state_up — See Argument Reference above.

  • network_id — See Argument Reference above.

  • device_owner — See Argument Reference above.

  • mac_address — See Argument Reference above.

  • device_id — See Argument Reference above.

  • allowed_address_pairs — An IP/MAC Address pair of additional IPaddresses that can be active on this port. The structure is describedbelow.

  • all_fixed_ips — The collection of Fixed IP addresses on the port in theorder returned by the Network v2 API.

  • all_security_group_ids — The set of security group IDs applied on the port.

  • all_tags — The set of string tags applied on the port.

  • extra_dhcp_option — An extra DHCP option configured on the port.The structure is described below.

  • binding — The port binding information. The structure is described below.

  • dns_name — See Argument Reference above.

  • dns_assignment — The list of maps representing port DNS assignments.

The allowed_address_pairs attribute has fields below:

  • ip_address — The additional IP address.

  • mac_address — The additional MAC address.

The extra_dhcp_option attribute has fields below:

  • name — Name of the DHCP option.

  • value — Value of the DHCP option.

  • ip_version — IP protocol version

The binding attribute has fields below:

  • host_id — The ID of the host that has the allocatee port.

  • profile — A JSON string containing the binding profile information.

  • vnic_type — VNIC type for the port.

  • vif_details — A map of JSON strings containing additional details for this specific binding.

  • vif_type — The VNIC type of the port binding.