跳至内容

~> 弃用通知 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 - 启用或禁用 ​​后端传输，默认值为 false。
  • bgp_config - 可选的 BGP 设置。请参阅 Equinix Metal 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}
此页面有帮助吗？