Aviso de Descontinuação O Equinix Metal alcance ao fim de sua vida útil em 30 de junho de 2026 Todas as fontes de dados Metal serão removidas na versão 5.0.0 deste provedor. Use a versão 4.x deste provedor para continuar utilizando-o até o encerramento das atividades. Consulte https://docs.equinix.com/metal/ para obter mais informações.

dispositivos_de_metal_equinix

A fonte de dados pode ser usada para encontrar uma lista de dispositivos que atendam aos critérios de filtro.

Se você precisar buscar um único dispositivo por ID ou por ID de projeto e nome do host, use a fonte de dados equinix_metal_device.

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

pesquisa vs filtro

A diferença entre search e filter é que search é um parâmetro de API, interpretado pelo serviço Equinix Metal . Os argumentos "filter" reduzirão os resultados da lista da API (ou busca) aplicando filtragem do lado do cliente, dentro deste provedor.

Referência do argumento

Os seguintes argumentos são suportados:

• project_id - (Opcional) ID do projeto que contém os dispositivos. Exatamente um de project_id ou organization_id deve ser definido.
• organization_id - (Opcional) ID da organização que contém os dispositivos.
• search - (Opcional) - String de pesquisa para filtrar dispositivos por nome do host, descrição, short_id, short_id da reserva, tags, nome do plano, slug do plano, código da instalação, nome da instalação, nome do sistema operacional, slug do sistema operacional, endereços IP.
• filter - (Opcional) Um ou mais pares atributo/valor para filtrar. A lista de atributos para filtrar pode ser encontrada no esquema da fonte de dados equinix_metal_device.
  • attribute - (Obrigatório) O atributo usado para filtrar. Os atributos de filtro diferenciam maiúsculas de minúsculas.
  • values - (Obrigatório) Os valores do filtro. Os valores do filtro diferenciam maiúsculas de minúsculas. Se você especificar vários valores para um filtro, os valores serão unidos por um operador OR por padrão, e a solicitar retornará todos os resultados que corresponderem a qualquer um dos valores especificados.
  • match_by - (Opcional) O tipo de comparação a ser aplicada. Um dos seguintes: in, re, substring, less_than, less_than_or_equal, greater_than, greater_than_or_equal. O padrão é in.
  • all - (Opcional) Se definido como verdadeiro, os valores são unidos com um operador AND e a solicitação retorna apenas os resultados que correspondem a todos os valores especificados. O padrão é false.

Todos os campos no bloco devices definido abaixo podem ser usados ​​como atributo para os blocos sort e filter.

Referência de atributos

Além de todos os argumentos acima, os seguintes atributos são exportados:

• devices - lista de recursos com atributos como nos equninix_metal_device datasources.