Avis de fin de vie Equinix Metal ne sera plus pris en charge le 30 juin 2026 Toutes les sources de données Metal seront supprimées dans la version 5.0.0 de ce fournisseur. Pour continuer à utiliser ce service jusqu'à cette date, veuillez utiliser la version 4.x. Consultez la page https://docs.equinix.com/metal/ pour plus d'informations.

appareils métalliques Equinix

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

Si vous devez récupérer un seul appareil 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 d'API, interprété par le service Equinix Metal. Les arguments « filter » permettent de réduire les résultats de la liste (ou de la recherche) de l'API en appliquant un filtrage côté client, au sein de ce fournisseur.

Référence de l'argument

Les arguments suivants sont étayés:

• project_id - (Optionnel) ID du projet contenant les appareils. Seule l'une des valeurs project_id ou organization_id doit être renseignée.
• organization_id - (Optionnel) 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 du plan, slug du plan, code de l'établissement, nom de l'établissement, nom du système d'exploitation, slug du système d'exploitation, adresses IP.
• filter - (Optionnel) 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 filtrer. Les attributs du filtre 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, elles sont combinées par défaut avec un OU, et la requête retourne tous les résultats correspondant à au moins une des valeurs spécifiées.
  • match_by - (Optionnel) Le type de comparaison à appliquer. L'un des 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 « vraie », les valeurs sont combinées par un ET logique, et la requête ne retourne que les résultats correspondant à 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 attribut pour les blocs sort et filter.

Référence des attributs

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

• devices - liste de ressources avec des attributs comme dans les sources de données equninix_metal_device.