~> Deprecation Notice Equinix Metal arrivera en fin de vie le 30 juin 2026. Toutes les ressources Metal seront supprimées dans la version 5.0.0 de ce fournisseur. Utilisez la version 4.x de ce fournisseur pour continuer à l'utiliser jusqu'à la fin de sa durée de vie. Consultez https://docs.equinix.com/metal/ pour plus d'informations.
equinix_metal_connection (Ressource)
Utilisez cette ressource pour demander la création d'un actif d'interconnexion afin de vous connecter avec d'autres parties en utilisant [Equinix Fabric - interconnexions définies par logiciel.
Exemple d'utilisation
Fabric Billed Shared Virtual Connection - Connexion non redondante entre votre propre port Equinix Fabric et Equinix Metal.
resource "equinix_metal_vlan" "example" {
project_id = "<metal_project_id>"
metro = "FR"
}
resource "equinix_metal_connection" "example" {
name = "tf-metal-from-port"
project_id = "<metal_project_id>"
type = "shared"
redundancy = "primary"
metro = "FR"
speed = "200Mbps"
service_token_type = "z_side"
contact_email = "username@example.com"
vlans = [equinix_metal_vlan.example.vxlan]
}
data "equinix_fabric_ports" "a_side" {
filters {
name = "<name_of_port||port_prefix>"
}
}
resource "equinix_fabric_connection" "example" {
name = "tf-metal-from-port"
type = "EVPL_VC"
bandwidth = "200"
notifications {
type = "ALL"
emails = ["username@example.com"]
}
order { purchase_order_number = "1-323292" }
project { project_id = "<fabric_project_id>" }
a_side {
access_point {
type = "COLO"
port {
uuid = data.equinix_fabric_ports.a_side.data.0.uuid
}
link_protocol {
type = "DOT1Q"
vlan_tag = 1234
}
}
}
z_side {
service_token {
uuid = equinix_metal_connection.example.service_tokens.0.id
}
}
}
-> REMARQUE : il existe un [module Equinix Fabric L2 Connection To Equinix Metal Terraform disponible avec des exemples complets de connexions à partir de ports Fabric, de dispositifs Network Edge ou de jetons de service. Consultez l'[exemple de connexion partagée avec un jeton de service côté Z.
Connexion virtuelle partagée facturée à la Fabric - Connexion non redondante entre votre propre périphérique Network Edge et Equinix Metal.
resource "equinix_metal_vrf" "example" {
name = "tf-metal-from-ne"
metro = "FR"
local_asn = "65001"
ip_ranges = ["10.99.1.0/24"]
project_id = equinix_metal_project.test.id
}
resource "equinix_metal_connection" "example" {
name = "tf-metal-from-ne"
project_id = "<metal_project_id>"
type = "shared"
redundancy = "primary"
metro = "FR"
speed = "200Mbps"
service_token_type = "z_side"
contact_email = "username@example.com"
vrfs = [equinix_metal_vrf.example.vxlan]
}
resource "equinix_fabric_connection" "example" {
name = "tf-metal-from-ne"
type = "EVPL_VC"
bandwidth = "200"
notifications {
type = "ALL"
emails = ["username@example.com"]
}
order { purchase_order_number = "1-323292" }
project { project_id = "<fabric_project_id>" }
a_side {
access_point {
type = "VD"
virtual_device {
type = "EDGE"
uuid = equinix_network_device.example.id
}
}
}
z_side {
service_token {
uuid = equinix_metal_connection.example.service_tokens.0.id
}
}
}
Fabric Billed Shared Virtual Connection- Connexion non redondante entre Equinix Fabric Cloud Router et Equinix Metal.
resource "equinix_metal_vlan" "example1" {
project_id = "<metal_project_id>"
metro = "SV"
}
resource "equinix_metal_connection" "example" {
name = "tf-metal-from-fcr"
project_id = "<metal_project_id>"
metro = "SV"
redundancy = "primary"
type = "shared_port_vlan"
contact_email = "username@example.com"
speed = "200Mbps"
vlans = [equinix_metal_vlan.example1.vxlan]
}
resource "equinix_fabric_connection" "example" {
name = "tf-metal-from-fcr"
type = "IP_VC"
bandwidth = "200"
notifications {
type = "ALL"
emails = ["username@example.com"]
}
project { project_id = "<fabric_project_id>" }
a_side {
access_point {
type = "CLOUD_ROUTER"
router {
uuid = equinix_fabric_cloud_router.example.id
}
}
}
z_side {
access_point {
type = "METAL_NETWORK"
authentication_key = equinix_metal_connection.example.authorization_code
}
}
}
Metal Billed Shared Virtual Connection - Connexion redondante entre Equinix Metal et un fournisseur de services cloud.
resource "equinix_metal_connection" "example" {
name = "tf-metal-2-azure"
project_id = "<metal_project_id>"
type = "shared"
redundancy = "redundant"
metro = "SV"
speed = "1Gbps"
service_token_type = "a_side"
contact_email = "username@example.com"
}
data "equinix_fabric_service_profiles" "zside" {
filter {
property = "/name"
operator = "="
values = ["Azure ExpressRoute"]
}
}
resource "equinix_fabric_connection" "example_primary" {
name = "tf-metal-2-azure-pri"
type = "EVPL_VC"
bandwidth = azurerm_express_route_circuit.example.bandwidth_in_mbps
redundancy { priority = "PRIMARY" }
notifications {
type = "ALL"
emails = ["username@example.com"]
}
project { project_id = "<fabric_project_id>" }
a_side {
service_token {
uuid = equinix_metal_connection.example.service_tokens.0.id
}
}
z_side {
access_point {
type = "SP"
authentication_key = azurerm_express_route_circuit.example.service_key
profile {
type = "L2_PROFILE"
uuid = data.equinix_fabric_service_profiles.zside.id
}
location {
metro_code = "SV"
}
}
}
}
resource "equinix_fabric_connection" "example_secondary" {
name = "tf-metal-2-azure-sec"
type = "EVPL_VC"
bandwidth = azurerm_express_route_circuit.example.bandwidth_in_mbps
redundancy {
priority = "SECONDARY"
group = one(equinix_fabric_connection.example_primary.redundancy).group
}
notifications {
type = "ALL"
emails = ["username@example.com"]
}
project { project_id = "<fabric_project_id>" }
a_side {
service_token {
uuid = equinix_metal_connection.example.service_tokens.1.id
}
}
z_side {
access_point {
type = "SP"
authentication_key = azurerm_express_route_circuit.example.service_key
profile {
type = "L2_PROFILE"
uuid = data.equinix_fabric_service_profiles.zside.id
}
location {
metro_code = "SV"
}
}
}
}
-> NOTE : Il existe plusieurs [modules Equinix Fabric L2 Connection Terraform disponibles avec des exemples complets de connexions depuis les ports Fabric, les dispositifs Network Edge ou les jetons de service vers les fournisseurs de services cloud les plus courants. Consultez les exemples de connexion partagée Equinix Metal avec un jeton de service côté A inclus dans chacun d'entre eux : AWS, Azure, [Google Cloud, [IBM Cloud, [Oracle Cloud, [Alibaba Cloud.
Connexion virtuelle partagée facturée au Metal - Connexion non redondante depuis Equinix Metal vers votre propre port Equinix Fabric.
resource "equinix_metal_connection" "example" {
name = "tf-metal-2-port"
project_id = "<metal_project_id>"
type = "shared"
redundancy = "redundant"
metro = "FR"
speed = "1Gbps"
service_token_type = "a_side"
contact_email = "username@example.com"
}
data "equinix_fabric_ports" "a_side" {
filters {
name = "<name_of_port||port_prefix>"
}
}
resource "equinix_fabric_connection" "example" {
name = "tf-metal-2-port"
type = "EVPL_VC"
notifications {
type = "ALL"
emails = ["username@example.com"]
}
project {
project_id = "<fabric_project_id>"
}
bandwidth = "100"
order {
purchase_order_number = "1-323292"
}
a_side {
service_token {
uuid = equinix_metal_connection.example.service_tokens.0.id
}
}
z_side {
access_point {
type = "COLO"
port {
uuid = data.equinix_fabric_ports.a_side.data.0.uuid
}
link_protocol {
type = "DOT1Q"
vlan_tag = 1234
}
}
}
}
Schéma
Exigée
name(Chaîne) Nom de la ressource de connexionredundancy(Chaîne) Redondance de la connexion - redondante ou primairetype(String) Type de connexion - dédiée, partagée ou shared_port_vlan
En option
contact_email(Chaîne) Le courriel préféré utilisé pour la communication et les notifications concernant l'interconnexion Equinix Fabric.description(Chaîne) Description de la ressource de connexionfacility(String, Deprecated) Installation où la connexion sera crééemetro(String) Metro-Connect où la connexion sera crééemode(Chaîne) Mode pour les connexions dans les installations IBX avec le type dédié - standard ou tunnelorganization_id(Chaîne) ID de l'organisation responsable de la connexion. Applicable avec le type "dedicated"project_id(Chaîne) ID du projet auquel la connexion est rattachée. Obligatoire avec le type "shared"service_token_type(Chaîne) Utilisé uniquement avec une connexion partagée. Type de jeton de service à utiliser pour la connexion, a_side ou z_side.speed(Chaîne) Vitesse de connexion - Les valeurs doivent être au format "Mbps " ou " Gpbs ", par exemple " 100Mbps " ou " 50Gbps ". Les valeurs réelles prises en charge dépendent du type de connexion et de l'utilisation ou non de VLAN ou de VRF. tags(List of String) Tags attachés à la connexionvlans(Liste de numéros) Uniquement utilisé avec une connexion partagée. VLANs à attacher. Passez un vlan pour la connexion primaire/unique et deux vlans pour la connexion redondante.vrfs(Liste de chaînes) Uniquement utilisé avec une connexion partagée. VRF à attacher. Passez un VRF pour la connexion primaire/unique et deux VRF pour la connexion redondante.
En lecture seule
authorization_code(Chaîne) Utilisé uniquement avec la connexion Fabric Shared. Fabric utilise ce jeton pour pouvoir donner des informations plus détaillées sur l'extrémité Metal du réseau, lors de la visualisation des ressources à partir de Fabric.id(Chaîne) L'identifiant unique de la ressourceports(Liste d'objets) Liste des ports de connexion - primaires (ports[0]) et secondaires (ports[1]) (voir ci-dessous pour le schéma imbriqué)service_tokens(Liste d'objets) Utilisé uniquement avec une connexion partagée. Liste des jetons de service nécessaires pour poursuivre le processus de configuration avec equinix_fabric_connection ou à partir du [Equinix Fabric Portal (voir ci-dessous pour le schéma imbriqué).status(Chaîne) État de la ressource de connexiontoken(String, Deprecated) Uniquement utilisé avec une connexion partagée. Jeton Fabric requis pour poursuivre le processus de configuration avec equinix_fabric_connection ou à partir du [Equinix Fabric Portal.
Schéma imbriqué pour ports
En lecture seule :
id(Chaîne)link_status(Chaîne)name(Chaîne)role(Chaîne)speed(Nombre)status(Chaîne)virtual_circuit_ids(Liste de chaînes)
Schéma imbriqué pour service_tokens
En lecture seule :
expires_at(Chaîne)id(Chaîne)max_allowed_speed(Chaîne)role(Chaîne)state(Chaîne)type(Chaîne)