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

equinix_metal_project（リソース）

Equinix Metalプロジェクトリソースを提供し、プロジェクト内のデバイスを管理できます。

->注: Equinix Metalの請求書はプロジェクト単位であるため、equinix_metal_projectリソースを多数作成すると請求書のレンダリングに影響します。Equinix Metalの請求書をシンプルで見やすいものにしたい場合は、既存のプロジェクトを再利用してください。

使用例

新規プロジェクトの作成

resource "equinix_metal_project" "tf_project_1" {
  name = "Terraform Fun"
}

BGPコンフィグを使用した例

# Create a new Project
resource "equinix_metal_project" "tf_project_1" {
  name = "tftest"
  bgp_config {
    deployment_type = "local"
    md5             = "C179c28c41a85b"
    asn             = 65000
  }
}

既存プロジェクトでのBGPの有効化

既存のEquinix MetalプロジェクトでBGPを有効にする場合は、まずTFコンフィグで既存プロジェクト用のリソースを作成してください。BGP設定を行います。

resource "equinix_metal_project" "existing_project" {
  name = "The name of the project (if different, will rewrite)"
  bgp_config {
    deployment_type = "local"
    md5             = "C179c28c41a85b"
    asn             = 65000
  }
}

次に、既存のプロジェクトのUUIDを調べ、それをTF状態にインポートします。

terraform import equinix_metal_project.existing_project e188d7db-46a7-46cb-8969-e63ec22695d5

既存のプロジェクトがローカルの TF 状態にロードされ、指定した名前のリソースにリンクされました。

terraform applyを実行すると、TFテンプレートで提供された設定でプロジェクトが更新されます。

引数リファレンス

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

name - （必須）プロジェクトの名前。最大80文字です。
organization_id - （必須）プロジェクトを作成する組織の UUID。未入力の場合、プロジェクトはアカウントのデフォルト組織の下に作成されます。
payment_method_id - このプロジェクトの支払い方法の UUID。支払い方法とプロジェクトは同じ組織に属する必要があります（organization_id で渡される、またはデフォルト）。
backend_transfer - バックエンド転送を有効または無効にします。
bgp_config - オプションのBGP設定です。Equinix Metal guide for BGPを参照してください。

->注: 一度プロジェクトでBGPコンフィグを設定すると、（Equinix Metal APIの制限により）削除できません。更新は可能です。

bgp_configブロックがサポートしています：

asn - （必須）ローカル BGP 展開のための自律システム番号。
deployment_type-（必須）localまたはglobal、localはすぐに利用可能、globalはEquinix Metalエンジニアによる審査が必要です。
md5 - （オプション）BGPセッションのパスワードを平文で指定します（チェックサムではありません）。

属性リファレンス

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

id - プロジェクトの一意の ID。
created - プロジェクトが作成された時のタイムスタンプ。
updated - プロジェクトが最後に更新されたタイムスタンプ。

bgp_configブロックはさらにエクスポートします：

status - プロジェクト内の BGP 構成のステータス。
max_prefix - サーバーごとに許可されるルートフィルタの最大数です。

インポート

このリソースは、既存のプロジェクトIDを使用してインポートできます：

terraform import equinix_metal_project {existing_project_id}

使用例​

新規プロジェクトの作成​

BGPコンフィグを使用した例​

既存プロジェクトでのBGPの有効化​

引数リファレンス​

属性リファレンス​

インポート​

使用例