~> Deprecation Notice Equinix Metal llegará al final de su vida útil en 30 de junio de 2026. Todas las fuentes de datos Metal se eliminarán en la versión 5.0.0 de este proveedor. Utilice la versión 4.x de este proveedor para seguir utilizándolo hasta el final de su vida útil. Consulte https://docs.equinix.com/metal/ para obtener más información.

dispositivos_metal_equinix

La fuente de datos puede utilizarse para encontrar una lista de dispositivos que cumplan los criterios de filtrado.

Si necesita obtener un único dispositivo por ID o por ID de proyecto y nombre de host, utilice la fuente de datos equinix_metal_device.

Ejemplo de uso

# Following example will select c3.small.x86 devices which are deplyed in metro 'da' (Dallas)
# OR 'sv' (Sillicon Valley).
data "equinix_metal_devices" "example" {
    project_id = local.project_id
    filter {
        attribute = "plan"
        values    = ["c3.small.x86"]
    }
    filter {
        attribute = "metro"
        values    = ["da", "sv"]
    }
}

output "devices" {
    organization_id = local.org_id
    value = data.equinix_metal_devices.example.devices
}

# Following example takes advantage of the `search` field in the API request, and will select devices with
# string "database" in one of the searched attributes. See `search` in argument reference.
data "equinix_metal_devices" "example" {
    search = "database"
}

output "devices" {
    value = data.equinix_metal_devices.example.devices
}

buscar vs filtrar

La diferencia entre search y filter es que search es un parámetro API, interpretado por el servicio Equinix Metal. Los argumentos "filtro" reducirán los resultados de la lista (o búsqueda) de la API aplicando un filtrado del lado del cliente, dentro de este proveedor.

Argumento de referencia

Se admiten los siguientes argumentos:

• project_id - (Opcional) ID del proyecto que contiene los dispositivos. Debe establecerse exactamente uno de project_id y organization_id.
• organization_id - (Opcional) ID de la organización que contiene los dispositivos.
• search - (Opcional) - Cadena de búsqueda para filtrar dispositivos por nombre de host, descripción, short_id, short_id de reserva, etiquetas, nombre de plan, slug de plan, código de instalación, nombre de instalación, nombre de sistema operativo, slug de sistema operativo, direcciones IP.
• filter - (Opcional) Uno o más pares atributo/valor a filtrar. La lista de atributos a filtrar se encuentra en el esquema de la fuente de datos equinix_metal_device.
  • attribute - (Obligatorio) El atributo utilizado para filtrar. Los atributos de filtrado distinguen entre mayúsculas y minúsculas
  • values - (Obligatorio) Los valores del filtro. Los valores del filtro distinguen entre mayúsculas y minúsculas. Si especifica varios valores para un filtro, los valores se unen con un OR por defecto, y la solicitud devuelve todos los resultados que coincidan con cualquiera de los valores especificados
  • match_by - (Opcional) El tipo de comparación a aplicar. Uno de los siguientes: in , re, substring, less_than, less_than_or_equal, greater_than, greater_than_or_equal. Por defecto es in.
  • all - (Opcional) Si se establece en true, los valores se unen con un AND, y las peticiones devuelven sólo los resultados que coinciden con todos los valores especificados. Por defecto es false.

Todos los campos del bloque devices definido a continuación pueden utilizarse como atributo tanto para el bloque sort como para el bloque filter.

Atributos Referencia

Además de todos los argumentos anteriores, se exportan los siguientes atributos:

• devices - lista de recursos con atributos como en equninix_metal_device datasources.