~> Deprecation Notice Equinix Metal will reach end of life on June 30, 2026. All Metal data sources will be removed in version 5.0.0 of this provider. Use version 4.x of this provider for continued use through sunset. See https://docs.equinix.com/metal/ for more information.

equinix_metal_reserved_ip_block (Data Source)

Use this data source to find IP address blocks in Equinix Metal. You can use IP address or a block ID for lookup.

~> For backward compatibility, this data source can be also used for precreated (management) IP blocks.

See the Virtual Routing and Forwarding documentation for product details and API reference material.

Example Usage

Look up an IP address for a domain name, then use the IP to look up the containing IP block and run a device with IP address from the block:

data "dns_a_record_set" "www" {
  host = "www.example.com"
}

data "equinix_metal_reserved_ip_block" "www" {
  project_id = local.my_project_id
  address = data.dns_a_record_set.www.addrs[0]
}

resource "equinix_metal_device" "www" {
  project_id = local.my_project_id
  [...]
  ip_address {
    type = "public_ipv4"
    reservation_ids = [data.equinix_metal_reserved_ip_block.www.id]
  }
}

Argument Reference

The following arguments are supported:

• id - (Optional) UUID of the IP address block to look up.
• project_id - (Optional) UUID of the project where the searched block should be.
• ip_address - (Optional) Block containing this IP address will be returned.

-> NOTE: You should pass either id, or both project_id and ip_address.

Attributes Reference

This datasource exposes the same attributes as the equinix_metal_reserved_ip_block resource, with the following differences:

• type - One of global_ipv4, public_ipv4, private_ipv4, public_ipv6,or vrf