~> Deprecation Notice Equinix Metal llegará al final de su vida útil en 30 de junio de 2026. Todos los recursos Metal se eliminarán en la versión 5.0.0 de este proveedor. Utilice la versión 4.x de este proveedor para seguir utilizándolo hasta el final de su vida útil. Consulte https://docs.equinix.com/metal/ para obtener más información.

equinix_metal_project (Recurso)

Proporciona un recurso de proyecto Equinix Metal para permitirle gestionar dispositivos en sus proyectos.

-> NOTA: Tenga en cuenta que la facturación de Equinix Metal es por proyecto, por lo que crear muchos equinix_metal_project recursos afectará a la factura renderizada. Si desea que su factura de Equinix Metal sea sencilla y fácil de revisar, reutilice sus proyectos existentes.

Ejemplo de uso

Crear un nuevo proyecto

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

Ejemplo con configuración BGP

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

Habilitación de BGP en un proyecto existente

Si desea habilitar BGP en un proyecto Equinix Metal existente, primero debe crear un recurso en su configuración TF para los proyectos existentes. Establezca su configuración 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
  }
}

A continuación, averigüe el UUID del proyecto existente e impórtelo a su estado TF.

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

Su proyecto existente está ahora cargado en su estado local TF, y vinculado al recurso con nombre dado.

Tras ejecutar terraform apply, el proyecto se actualizará con la configuración proporcionada en la plantilla TF.

Argumento de referencia

Se admiten los siguientes argumentos:

• name - (Obligatorio) El nombre del proyecto. La longitud máxima es de 80 caracteres
• organization_id - (Obligatorio) El UUID de la organización bajo la que desea crear el proyecto. Si lo omite, el proyecto se creará bajo la organización por defecto de su cuenta.
• payment_method_id - El UUID del método de pago para este proyecto. El método de pago y el proyecto tienen que pertenecer a la misma organización (se pasa con organization_id, o por defecto).
• backend_transfer - Habilitar o deshabilitar [Transferencia Backend, por defecto es false.
• bgp_config - Ajustes BGP opcionales. Consulte la [Guía de Equinix Metal para BGP.

-> NOTA: Una vez establecida la configuración BGP en un proyecto, no puede eliminarse (debido a una limitación en la API de Equinix Metal). Sí puede actualizarse.

El bloque bgp_config es compatible:

• asn - (Obligatorio) Número de sistema autónomo para el despliegue local de BGP.
• deployment_type - (Obligatorio) local o global, el local es probable que se pueda utilizar inmediatamente, el global tendrá que ser revisado por los ingenieros de Equinix Metal.
• md5 - (Opcional) Contraseña para la sesión BGP en texto plano (no una suma de comprobación).

Atributos Referencia

Además de todos los argumentos anteriores, se exportan los siguientes atributos:

• id - El ID único del proyecto.
• created - La fecha de creación del proyecto.
• updated - La marca de tiempo de la última vez que se actualizó el proyecto.

El bloque bgp_config exporta adicionalmente:

• status - estado de la configuración de BGP en el proyecto.
• max_prefix - El número máximo de filtros de ruta permitidos por servidor.

Importar

Este recurso puede importarse utilizando un ID de proyecto existente:

terraform import equinix_metal_project {existing_project_id}