~> Deprecation Notice Equinix Metal arrivera en fin de vie le 30 juin 2026. Toutes les sources de données Metal seront supprimées dans la version 5.0.0 de ce fournisseur. Utilisez la version 4.x de ce fournisseur pour continuer à l'utiliser jusqu'à la fin de sa durée de vie. Pour plus d'informations, consultez le site https://docs.equinix.com/metal/.

equinix_metal_devices

La source de données peut être utilisée pour trouver une liste d'appareils qui répondent aux critères de filtrage.

Si vous avez besoin de récupérer un seul dispositif par ID ou par ID de projet et nom d'hôte, utilisez la source de données equinix_metal_device.

Exemple d'utilisation

# 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
}

recherche vs filtre

La différence entre search et filter est que search est un paramètre API, interprété par le service Metal d'Equinix. Les arguments "filter" réduisent les résultats de la liste API (ou de la recherche) en appliquant un filtrage côté client, au sein de ce fournisseur.

Référence de l'argument

Les arguments suivants sont soutenus :

• project_id - (Facultatif) ID du projet contenant les appareils. Un seul des éléments project_id et organization_id doit être défini.
• organization_id - (Facultatif) ID de l'organisation contenant les appareils.
• search - (Facultatif) - Chaîne de recherche pour filtrer les appareils par nom d'hôte, description, short_id, short_id de réservation, tags, nom de plan, Slug de plan, code d'installation, nom d'installation, nom de système d'exploitation, slug de système d'exploitation, adresses IP.
• filter - (Facultatif) Une ou plusieurs paires attribut/valeur à filtrer. La liste des attributs à filtrer se trouve dans le schema de la source de données equinix_metal_device.
  • attribute - (Obligatoire) L'attribut utilisé pour le filtrage. Les attributs de filtrage sont sensibles à la casse
  • values - (Obligatoire) Les valeurs du filtre. Les valeurs du filtre sont sensibles à la casse. Si vous spécifiez plusieurs valeurs pour un filtre, les valeurs sont jointes par défaut à l'aide d'un OU et la requête renvoie tous les résultats qui correspondent à l'une des valeurs spécifiées
  • match_by - (Facultatif) Le type de comparaison à appliquer. L'un des éléments suivants in , re, substring, less_than, less_than_or_equal, greater_than, greater_than_or_equal. La valeur par défaut est in.
  • all - (Facultatif) Si la valeur est égale à true, les valeurs sont jointes par un AND et les requêtes ne renvoient que les résultats qui correspondent à toutes les valeurs spécifiées. La valeur par défaut est false.

Tous les champs du bloc devices défini ci-dessous peuvent être utilisés comme attributs pour les blocs sort et filter.

Référence des attributs

En plus de tous les arguments ci-dessus, les attributs suivants sont exportés :

• devices - liste de ressources avec des attributs comme dans equninix_metal_device datasources.