~> 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_facility (Data Source)

Deprecated Use equinix_metal_metro instead. For more information, refer to the facility to metro migration guide.

Provides an Equinix Metal facility datasource.

Example Usage

# Fetch a facility by code and show its ID

data "equinix_metal_facility" "ny5" {
  code = "ny5"
}

output "id" {
  value = data.equinix_metal_facility.ny5.id
}

# Verify that facility "dc13" has capacity for provisioning 2 c3.small.x86 
  devices and 1 c3.medium.x86 device and has specified features

data "equinix_metal_facility" "test" {
  code = "dc13"

  features_required = ["backend_transfer", "global_ipv4"]

  capacity {
    plan = "c3.small.x86"
    quantity = 2
  }

  capacity {
    plan = "c3.medium.x86"
    quantity = 1
  }
}

Argument Reference

The following arguments are supported:

• code - (Required) The facility code to search for facilities.
• features_required - (Optional) Set of feature strings that the facility must have. Some possible values are baremetal, ibx, storage, global_ipv4, backend_transfer, layer_2.
• capacity - (Optional) One or more device plans for which the facility must have capacity.
  • plan - (Required) Device plan that must be available in selected location.
  • quantity - (Optional) Minimun number of devices that must be available in selected location. Default is 1.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

• id - The ID of the facility.
• name - The name of the facility.
• features - The features of the facility.
• metro - The metro code the facility is part of.