本文へスキップ

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

equinix_metal_port（リソース）

Equinix Metalデバイスのネットワークポートを設定するには、このリソースを使用します。このリソースは、物理ポートとボンドポートの両方を制御できます。

このTerraformリソースは、Equinix MetalのAPIリソースを作成するのではなく、レイヤ2ネットワーキングをより細かく制御します。

参照されるポート・リソースはデバイスと共に作成され、デバイス・リソース経由または /port/<uuid> API パス経由でアクセスできます。

-> ポータルで利用可能なネットワーク構成を実現するには、さまざまなequinix_metal_portリソースの作成と組み合わせが必要な場合があります。このリソースの例については、ネットワーク タイプ ガイド を参照してください。

引数リファレンス​

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

  • port_id - （必須）読み込むポートの ID。
  • bonded - （必須）ポートをボンディングするかどうか。
  • layer2 - （オプション）ポートをレイヤ 2 モードにするかどうか。
  • vlan_ids - （オプション）ポートにアタッチする VLAN UUID のリスト。
  • vxlan_ids - （オプション）ポートにアタッチする VXLAN ID のリスト。
  • native_vlan_id - （オプション）ネイティブ VLAN として割り当てる VLAN の UUID。アタッチされた VLAN の 1 つである必要があります（vlan_ids パラメータ）。
  • reset_on_delete - (オプション) 削除/破棄する前にポートをデフォルト設定 (vlan がアタッチされていないレイヤー3ボンデッドモード) にリセットするための動作設定です。

タイムアウト​

timeouts ブロックでは、特定のアクションに対して タイムアウト を指定できます：

これらのタイムアウトには、ディスボンド、L2/L3 への変換、ボンド、ネイティブ vLAN の更新にかかる時間が含まれます。

  • {ポート作成時に使用します。
  • update - （デフォルトは 30 分）ポートを更新するときに使用します。
  • delete - （デフォルトは 30 分）ポートを削除するときに使用します。

属性リファレンス​

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

  • name - ポートの名前（bond0 または eth0など）。
  • network_type - レイヤー2ボンディング、レイヤー2個別、レイヤー3、ハイブリッド、ハイブリッドボンディングのいずれか。この属性はボンド・ポートにのみ設定されます。
  • type - タイプは、ボンドポートの場合は "NetworkBondPort"、ボンディング可能なイーサネットポートの場合は "NetworkPort "です。
  • mac - ポートの MAC アドレス。
  • bond_id - ボンドポートの UUID。
  • bond_name - ボンドポートの名前です。
  • disbond_supported - ポートをボンドから削除できるかどうかを示すフラグ。
このページは役に立ちましたか？