本文へスキップ

~>非推奨のお知らせ Equinix Metalは、2026年6月30日 をもってサービスを終了します。すべてのMetalデータソースは、このプロバイダのバージョン5.0.0で削除されます。廃止までの継続利用には、このプロバイダのバージョン4.xをご利用ください。詳細は https://docs.equinix.com/metal/ をご覧ください。

エクイニクス_メタルデバイス

データソースを使用して、フィルタ条件を満たすデバイスのリストを検索できます。

単一のデバイスを ID またはプロジェクト ID とホスト名で取得する必要がある場合は、equinix_metal_device データソースを使用してください。

使用例​

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

検索 vs フィルター​

searchとfilterの違いは、searchがAPIパラメータであり、Equinix Metalサービスが解釈する点です。filter」引数は、このプロバイダ内でクライアント側のフィルタリングを適用することにより、APIリスト（または検索）結果を削減します。

引数リファレンス​

以下の引数をサポートしています：

  • project_id - （オプション）デバイスを含むプロジェクトの ID。project_idとorganization_idのうち正確に1つを設定する必要があります。
  • organization_id - （オプション）デバイスを含む組織の ID。
  • search - (オプション) - ホスト名、説明、short_id、予約short_id、タグ、プラン名、プランスラグ、施設コード、施設名、オペレーティングシステム名、オペレーティングシステムスラグ、IPアドレスによってデバイスをフィルタリングするための検索文字列。
  • filter - （オプション）フィルタリングする 1 つ以上の属性/値のペア。フィルタリングする属性のリストは equinix_metal_device データソースの schemaにあります。
    • attribute - （必須）フィルタリングに使用する属性。フィルタ属性は大文字と小文字を区別します。
    • values - （必須）フィルタ値。フィルター値は大文字と小文字を区別します。フィルターに複数の値を指定した場合、デフォルトでは値は OR で結合され、リクエストは指定された値のいずれかに一致するすべての結果を返します。
    • match_by - （オプション）適用する比較のタイプ。のいずれかです：in, re, substring, less_than, less_than_or_equal, greater_than, greater_than_or_equal.デフォルトは in です。
    • all - (オプション) true に設定すると、値は AND で結合され、要求 は指定されたすべての値に一致する結果のみを返します。デフォルトは false です。

以下に定義する devices ブロックのすべてのフィールドは、sort と filter ブロックの両方の属性として使用できます。

属性リファレンス​

上記のすべての引数に加えて、以下の属性がエクスポートされます：

このページは役に立ちましたか？