Fabric Billed Fabric Virtual Connections (Connexions virtuelles de la Fabric)

Les connexions virtuelles Fabric facturées par Fabric permettent d'établir une connexion entre vos ports Fabric ou vos périphériques Network Edge Network Edge et Equinix Metal, au sein d'une même zone métropolitaine ou entre plusieurs zones métropolitaines. Elles peuvent notamment servir de routeur pour vos services Equinix Metal ou connecter Equinix Metal à un fournisseur de services cloud dans plusieurs zones métropolitaines. Tous les frais d'utilisation, de Network Edge et de périphériques virtuels seront facturés sur votre compte Equinix Fabric .

Remarque: cette fonctionnalité remplace les ports partagés pour les utilisateurs précédents d’équipements Equinix Fabric et Network Edge par leur infrastructure Equinix Metal. Les interconnexions de ports partagés existantes continueront de fonctionner et seront indiquées comme « Héritées » dans le portail et l’API.

Informations système

Chaque connexion virtuelle Fabric peut être un port unique ou un ensemble de ports redondants. Les ports redondants sont recommandés pour une haute disponibilité. Avec un seul port, la disponibilité n'est pas garantie.
Chaque connexion virtuelle Fabric est fournie avec un circuit virtuel unique auquel vous pouvez vous connecter à un VLAN ou à un VRF. Si vous utilisez des ports redondants, chaque port disposera d'un circuit virtuel.
La relation entre les circuits virtuels et les VLAN est de 1:1. Vous ne pouvez connecter qu'un seul VLAN à un seul circuit virtuel, et un seul circuit virtuel à un seul VLAN. Un même VLAN ne peut pas être connecté à deux circuits virtuels ou plus. Par conséquent, si vous concevez un réseau haute disponibilité avec des ports primaires et secondaires, vous aurez besoin d'un VLAN pour chacun, ainsi que d'un routage inter-VLAN ou d'une autre fonctionnalité de reconnaissance des applications de couche 3.
Pour le routage, les connexions virtuelles Fabric peuvent utiliser le routage et le transfert virtuels (routage et transfert virtuels). Pour plus d'informations, consultez la page VRF pour les interconnexions (vrf-interconnections.mdx).
Les connexions virtuelles Fabric ont une bande passante maximale de 10 Gbit/s.
La connexion virtuelle Fabric prend en charge une unité de transmission maximale (MTU) jusqu'à 9 000 octets et des trames Ethernet jumbo.

Origines et destinations

Origin	Destination	Supported
Tout port physique sur Fabric (hors d'un Profil de service)	Facturation Fabric VC Fabric	Oui
Périphérique virtuel unique (non associé à un profil de service)	Appareil virtuel Fabric facturé	Oui
Périphérique virtuel en grappe (paire HA de périphérie réseau)	Appareil virtuel Fabric facturé	Non
VC en tissu à facturation métallique	VC en tissu à facturation textile	Non

Demande d'une connexion virtuelle Fabric facturée par Fabric

Console
CLI
API

Pour demander une connexion virtuelle Fabric, ouvrez la page Interconnexions du projet. Cliquez sur + Demander une nouvelle interconnexion.

Dans la section Type d'interconnexion, cliquez sur la liste déroulante sous Fabric VC et sélectionnez Fabric Billed.

New Fabric VC - Fabric Billed Request Page

Sélectionnez l'emplacement de la nouvelle connexion dans le menu déroulant. Choisissez la zone métropolitaine où se trouvent vos serveurs et VLAN Equinix Metal, ou celle où vous prévoyez de les provisionner.
Donnez un nom à votre connexion.
Choisissez si vous souhaitez un ensemble de ports redondants. Vous disposez d'un port principal et d'un port secondaire, chacun doté d'un circuit virtuel permettant de connecter deux VLAN, ce qui vous offre une certaine redondance et une haute disponibilité.
La vitesse d'interconnexion maximale est fixée par défaut à 10 Gbit/s. Vous sélectionnerez la vitesse réelle de la connexion lorsque vous activez votre jeton de service sur le portail Fabric.

Ensuite, sélectionnez si vous connectez vos ports à un VLAN ou à un VRF.

Si vous utilisez uniquement des VLAN, sélectionnez le ou les VLAN à connecter à vos ports. Ces VLAN doivent appartenir au même projet et au même emplacement que votre circuit virtuel Fabric. Si vous n'avez pas de VLAN compatible, cliquez sur + Créer un VLAN pour en créer. Un même VLAN ne peut être connecté qu'à un seul circuit virtuel ou plus. Par conséquent, si vous avez besoin de ports redondants, sélectionnez un VLAN pour chacun d'eux. Remarque: Vous ne pourrez plus modifier le VLAN une fois le circuit virtuel Fabric créé.
Si vous utilisez VRF, sélectionnez le VRF correspondant à vos ports. Vous trouverez des renseignements supplémentaires sur la page VRF pour les interconnexions.

Veuillez consulter le sommaire de votre demande. Cliquez sur Soumettre la demande pour recevoir vos jetons de service côté Z.

A Successful Connection Request Page

Les jetons expirent au bout de 7 jours. Vous recevrez également un courriel contenant vos jetons et les renseignements relatifs à leur expiration. Sur la page Interconnexions, votre nouvelle connexion virtuelle Fabric apparaîtra dans l'onglet Demandes en attente.

Pour demander un Fabric VC facturé par Fabric dans l'interface de ligne de commande, utilisez la commande metal interconnections create.

metal interconnections create -p <project_id> -n <name> -m <metro> -r redundant -t shared -T z_side [--vlans <vlan_id>, <vlan_id> | --vrfs <vrf_uuid>, <vrf_uuid>]

Options:

-p, --project-id (obligatoire) - L'UUID de votre projet.
-r, --redundancy - Sélectionnez primary ou redundant. Si vous sélectionnez une connexion redondante, vous obtiendrez un port principal et un port secondaire pour attacher des VLAN ou des VRF, augmentant ainsi la redondance et la haute disponibilité de la connexion.
-T, --service-token-type (obligatoire) - Ce paramètre est obligatoire lors de la demande d'une connexion virtuelle Fabric facturée par Fabric. Définissez la valeur à z_side.
-t, --type (obligatoire) - Ce paramètre est obligatoire lors de la demande d'une connexion virtuelle Fabric facturée par Fabric. Définissez la valeur à "shared".
--vlan" - Liste des ID de VLAN utilisés pour la connexion. En cas de connexion redondante, le premier VLAN de la liste sera utilisé pour le port principal et le second pour le port secondaire. Il est impossible de connecter le même VLAN aux deux ports ; précisez un VLAN différent pour chacun. Remarque: L’option vlan est obligatoire pour l’utilisation des VLAN. Ce champ est optionnel pour l'utilisation des VRF. Les VLAN ne pourront plus être modifiés après la création du Fabric VC.
--vrfs - Liste des VRF utilisées pour la connexion. En cas de connexion redondante, la première VRF de la liste sera utilisée pour le port principal et la seconde pour le port secondaire. Ces deux VRF peuvent être identiques si les ports principal et secondaire appartiennent à la même VRF. Remarque: L’option vrfs est obligatoire pour l’utilisation des VRF. Ce champ est optionnel pour l'utilisation des VLAN.

Remarque: Utilisez soit le champ "vlans", soit le champ "vrfs". Ils sont incompatibles et l'un ou l'autre est obligatoire.

L'envoi de la requête génère vos jetons de service côté Z. Ces jetons sont inclus dans l'objet de réponse. Si vous avez demandé une connexion redondante, vous recevrez deux jetons.

Pour établir une connexion via l'API, envoyez une requête POST au point de terminaison /projects/{project_id}/connections. Si vous associez des VLAN à ce Fabric VC, utilisez le paramètre "vlans" dans le corps de la requête. Si vous utilisez VRF, utilisez le paramètre vrfs dans le corps de la requête.

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{project_id}/connections" \
-d '{
    "name": "<string>",
    "description": "<string>",
    "contact_email": "<string>",
    "metro": "<metro_slug>",
    "type": "shared",
    "service_token_type": "z_side",
    "redundancy": "redundant",
    "vlans": [ <integer>, <integer> ]  
}'

Paramètres du corps:

"name" (obligatoire) - Le nom de votre nouvelle connexion virtuelle Fabric .
"description" (facultatif) - Une description conviviale pour votre connexion virtuelle Fabric .
"contact_email" - Adresse courriel privilégiée pour les communications et notifications relatives à l'interconnexion. Requis lors de l'utilisation d'une clé API de projet. Facultative et par défaut votre adresse courriel utilisateur lors de l'utilisation d'une clé API utilisateur.
"metro" (obligatoire) - Le métro où se trouve la connexion virtuelle Fabric .
"type" (obligatoire) - Ce paramètre est obligatoire lors de la demande d'une connexion virtuelle Fabric facturée par Fabric. Définissez la valeur à "shared".
"service_token_type" (obligatoire) - Ce paramètre est obligatoire lors de la demande d'une connexion virtuelle Fabric facturée par Fabric. Définissez la valeur à z_side.
"redundancy" (obligatoire) - Sélectionnez « primary » ou « redundant ». Si vous sélectionnez une connexion redondante, vous disposerez d'un port principal et d'un port secondaire pour connecter des VLAN ou des VRF, ce qui augmentera la redondance et la haute disponibilité de la connexion.
"vlans" - Liste des ID de VLAN utilisés pour la connexion. En cas de connexion redondante, le premier VLAN de la liste sera utilisé pour le port principal et le second pour le port secondaire. Il est impossible de connecter le même VLAN aux deux ports ; précisez un VLAN différent pour chacun. Remarque: le champ "vlans" est obligatoire si vous utilisez des VLAN. Si vous utilisez un VRF, ce champ est facultatif. Vous ne pourrez plus modifier les VLAN après la création du Fabric VC.
"vrfs" - Liste des VRF utilisées pour la connexion. En cas de connexion redondante, la première VRF de la liste sera utilisée pour le port principal et la seconde pour le port secondaire. Ces deux VRF peuvent être identiques si les ports principal et secondaire appartiennent à la même VRF. Remarque: Le champ "vrfs" est obligatoire pour l’utilisation des VRF. Il est optionnel pour l'utilisation des VLAN.

Remarque: Utilisez soit le champ "vlans", soit le champ "vrfs". Ils sont incompatibles et l'un ou l'autre est obligatoire.

L'envoi de la requête génère vos jetons de service côté serveur (z-side). Ces jetons sont inclus dans la réponse, dans l'objet "service_tokens". Si vous avez demandé une connexion redondante, vous recevrez deux jetons.

"service_tokens": [ 
    {
    “id”: "ff0cf4dc-a897-426d-9621-14e5b985058f",
    “role”: "primary",
    “state”: "inactive",
        “max_allowed_speed”: 10000000000,
    “service_token_type”: "z_side",
    “expires_at”: "2019-09-30T20:22:20",
    }
],

Les jetons expirent au bout de 7 jours. Vous recevrez également un courriel contenant vos jetons de service et les renseignements relatifs à leur expiration. Vous pouvez suivre votre demande et récupérer les jetons pendant cette période en envoyant une requête GET au point de terminaison /connections/{connection_id}.

curl -X GET -H 'X-Auth-Token: $API_TOKEN' \
"https://api.equinix.com/metal/v1/connections/{connection_id}"

Utilisation du jeton de service côté Z

Pour utiliser votre jeton, connectez-vous au portail Equinix Fabric et, dans le menu déroulant Connexions, cliquez sur Créer une connexion.

Create Connection Menu in the Fabric Portal

Sous Connexions fréquentes, sélectionnez la tuile Se connecter à l'aide d'un jeton de service, puis cliquez sur Saisir un jeton de service.

Service Token Tile in Fabric Connections Screen

Dans la boîte de dialogue, collez votre jeton dans le champ Entrez le jeton de service et cliquez sur Valider.

The Redeem Service Token Pane

Vérifiez que les détails du jeton sont corrects, puis cliquez sur Utiliser pour échanger votre jeton et terminer la configuration de votre connexion à Fabric.

Connexions héritées - Si vous avez déjà utilisé des ports partagés sur Equinix Metal, vous avez peut-être utilisé le champ « Jeton Fabric » pour activer votre jeton et configurer votre connexion. Si vous avez des connexions héritées existantes, elles continueront de fonctionner normalement. En revanche, si vous avez des jetons hérités non activés, il n'est plus possible de les activer sur Equinix Fabric. Vous devrez demander de nouveaux jetons de service et suivre la nouvelle procédure pour les activer dans Fabric.

Configuration de l'origine

Vous pouvez maintenant continuer à configurer votre connexion sur le portail Fabric . Puisque vous avez utilisé un jeton de service préconfiguré, Equinix Metal sera automatiquement défini comme destination de la connexion et vous pourrez choisir l'origine.

Tout d'abord, sélectionnez l'emplacement d'origine de la connexion. Il s'agit généralement d'un périphérique virtuel, mais il peut également s'agir de l'un de vos ports Equinix Fabric . Le périphérique virtuel ou le port peut se trouver dans n'importe quelle zone métropolitaine.

Location and Device Selection in Fabric Portal

Si vous utilisez un appareil virtuel, sélectionnez le type de périphérique et le type de connexion. Les périphériques et les grappes redondantes ne sont actuellement pas pris en charge.

Virtual Device Selection in Fabric Portal

Sur la page Détails de la connexion, attribuez un nom convivial à votre connexion virtuelle, précisez les interfaces du périphérique virtuel à utiliser (le cas échéant) et indiquez un numéro de bon de commande si votre organisation l'exige pour la facturation. Le VLAN côté serveur (z-side) est attribué automatiquement par le jeton de service et n'a pas besoin de correspondre à vos identifiants de VLAN sur Equinix Metal.

Connection Details in Fabric

Définissez ensuite la vitesse de connexion. Equinix Metal fixe la vitesse maximale pour les connexions virtuelles Fabric (facturées Fabric) à 10 Gbit/s. Choisissez parmi les options de vitesse et les tarifs Fabric .

Fabric Virtual Connection Speed Options

La dernière page est une page récapitulatif où vous pouvez vérifier vos choix et les modifier. Lorsque vous êtes prêt à passer une commande, cliquez sur Valider la commande. Cela lancera en arrière-plan un processus de configuration de la connexion entre Fabric et Equinix Metal, qui peut prendre jusqu'à 10 minutes.

Si vous avez reçu deux jetons pour une connexion redondante, assurez-vous de répéter la procédure pour utiliser votre deuxième jeton.

Pour récupérer les jetons, allez à l'onglet « Demande d'interconnexion ». Cliquez sur « Gérer » pour l'interconnexion concernée.

Interconnection Details Pane

Gestion des connexions virtuelles Fabric

Console
CLI
API

Une fois l'interconnexion établie entre Fabric et Equinix Metal, elle apparaîtra sur la page Interconnexions de votre projet, dans la section Fabric VC, avec le statut Actif.

Interconnections Page in the Console

Les connexions virtuelles Fabric Billed Fabric ont le type Fabric Billed.
Les connexions virtuelles Metal Billed Fabric ont le type Metal Billed.
Les interconnexions configurées comme Ports partagés sont indiquées par le type Legacy.

Notez que les ports dédiés sont gérés au niveau de l'organisation ; par conséquent, si votre organisation possède des ports dédiés, ils apparaîtront également dans la section Ports dédiés.

Cliquer sur le nom de l'interconnexion vous amène à sa page Aperçu, qui contient une vue détaillée ainsi qu'un résumé des configurations du port principal et du port secondaire.

Connection Overview

Cliquer sur Port principal ou Port secondaire affiche l'état et la configuration du port.

Dressez la liste de toutes les interconnexions de votre projet, y compris les connexions virtuelles Fabric facturées par Fabric, à l'aide de la commande metal interconnections get. Précisez le projet avec -p ou --project_id.

metal interconnections get -p <project_id>

Remarque: Les ports dédiés sont gérés au niveau de l'organisation et partagés entre les projets de celle-ci. Si votre organisation possède des ports dédiés, ils apparaîtront également dans la réponse.

Obtenez les détails d'une connexion virtuelle Fabric spécifique avec la commande metal interconnections get, en spécifiant la connexion virtuelle Fabric par son UUID et -i ou --connID.

metal interconnections get -i <fabric_vc_uuid>

Pour mettre à jour une connexion virtuelle Fabric, utilisez la commande metal interconnections update. L'UUID de la connexion virtuelle Fabric est obligatoire. Tous les autres champs sont optionnels et peuvent donc être mis à jour indépendamment.

metal interconnections update -i <fabric_vc_uuid> -n <name> -d <description> -r <redundant|primary> -e <e-mail> --tags="<tag1>,<tag2>"

Options:

-i, --id (obligatoire) - L'UUID de l'interconnexion.
-e, --contactEmail - Ajoute ou met à jour le contact de courriel pour la connexion virtuelle Fabric .
-n, --name - Met à jour le nom.
-d, --description - Ajoute ou met à jour la description.
-r, --redundancy - La mise à jour vers primary supprimera un port secondaire, tandis que la mise à jour vers redundant ajoutera un port secondaire.
-t, --tags - Ajoute ou met à jour les balises.

Pour lister toutes les interconnexions d'un projet, envoyez une requête GET au point de terminaison /organizations/{organization_id}/connections, en filtrant la réponse à votre projet dans le chemin de la requête.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/organizations/{organization_id}/connections?project={project_id}

Pour obtenir les détails d'un Fabric VC facturé par Fabric, envoyez une requête GET au point de terminaison /connections/{connection_id}, en spécifiant l'UUID dans le chemin de la requête.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}

Vous pouvez utiliser ces informations pour gérer et mettre à jour le Fabric Billed Fabric VC en envoyant une requête PUT au point de terminaison /connections/{connection_id}. Indiquez les modifications à apporter au corps de la requête. Tous les champs sont optionnels et peuvent donc être mis à jour indépendamment.

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/connections/{connection_id}" \
-d '{
    "contact_email": "<string>",
    "description": "<string>",
    "name": "<string>",
    "redundancy": "<string>",
    "tags": [
        "<string>"
    ]
}'

Paramètres du corps:

"contact_email" - Ajoute ou met à jour le contact de courriel pour la connexion virtuelle Fabric .
"name" - Met à jour le nom.
"description" - Ajoute ou met à jour la description.
"redundancy" - La mise à jour vers "primary" supprimera un port secondaire, tandis que la mise à jour vers "redundant" ajoutera un port secondaire.
"tags" - Ajoute ou met à jour les tags.

Vous pouvez également obtenir les informations de port de vos interconnexions.

Pour obtenir la liste des ports d'un Fabric VC facturé par Fabric, envoyez une requête GET au point de terminaison /connections/{connection_id}/ports.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports

Et pour obtenir l'un des détails du port, envoyez une requête GET au point de terminaison /connections/{connection_id}/ports/{id}.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports/{id}

Circuits virtuels

Chacun de vos ports, principal et secondaire, dispose d'un seul circuit virtuel auquel un VLAN ou un VRF peut être connecté.

Si vous utilisez des VLAN, vos circuits virtuels seront rattachés aux VLAN spécifiés. Ceux-ci ne peuvent pas être modifiés. Si vous avez besoin d'un Fabric VC avec un VLAN différent, vous devrez le supprimer et le recréer.

Remarque: Si vous avez précédemment ajouté, supprimé ou modifié des VLAN sur un circuit virtuel via la console ou l’API, ces options ne seront plus disponibles après 29 février 2024 Les requêtes de mise à jour (PUT) adressées au point de terminaison /virtual-circuits/{id} incluront un en-tête de fin de service dans leur réponse. Une exception est prévue uniquement pour les circuits virtuels Fabric provisionnés avant 1 mars 2024 et dont l’état est « En attente d’un VLAN client ».

Si vous utilisez VRF, vos circuits virtuels auront le statut « En attente des détails d'appariement ».

Configuration de VRF

Console
API

Si vous utilisez VRF sur vos circuits virtuels, cliquez sur le menu à trois barres pour ouvrir le panneau « Gérer les détails d'appariement ». Remplissez les champs avec les informations demandées.

C'est ici que vous spécifiez le sous-réseau de la plage d'adresses IP du VRF qui sera utilisé pour adresser le VRF et le côté distant du circuit virtuel. La réservation d'adresse IP pour ce sous-réseau sera créée automatiquement.

Une documentation plus détaillée est disponible sur la page VRF pour les interconnexions.

Cliquez sur Mettre à jour le circuit virtuel.

Si vous avez des ports redondants, répétez ce processus sur le port secondaire.

Pour mettre à jour votre circuit virtuel avec les détails d'appariement de votre VRF, envoyez une requête PUT au point de terminaison /virtual-circuits/{vrf_virtual_circuit_id}.

Pour les sous-réseaux IPv4:

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
    "peer_asn": <integer>,
    "subnet": "<subnet>",
    "metal_ip": "<ip_address>",
    "customer_ip": "<ip_address>”,
    "md5": "<string>"
}'

Pour les sous-réseaux IPv6:

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
    "peer_asn": <integer>,
    "subnet_ipv6": "<subnet>",
    "metal_ipv6": "<ip_address>",
    "customer_ipv6": "<ip_address>”,
    "md5": "<string>"
}'

Une documentation plus détaillée est disponible sur la page VRF pour les interconnexions.

Suppression d'une connexion virtuelle Fabric

avertissement

La suppression d'une connexion virtuelle Fabric est définitive. Lors de cette suppression, tous les VLAN connectés sont déconnectés et le trafic de Fabric vers vos serveurs est interrompu.

La suppression d'une connexion virtuelle facturée Fabric côté Equinix Metal supprime automatiquement la connexion dans Fabric. Si vous la supprimez du portail Fabric, elle sera également automatiquement nettoyée côté Equinix Metal . Ce processus asynchrone peut prendre jusqu'à 3 minutes.

Veuillez arrêter le trafic avant la suppression et nettoyer toutes les ressources associées à la connexion. Cette opération avant de supprimer la connexion du portail Metal ou Fabric garantit sa suppression complète et l'arrêt des frais de facturation.

Console
CLI
API

Dans la liste des connexions de la page Interconnexions, cliquez sur le nom de la connexion virtuelle Fabric que vous souhaitez supprimer.

Deleting a Connection Page

Cliquez sur Supprimer l'interconnexion pour supprimer définitivement la connexion virtuelle Fabric.

Pour supprimer une connexion virtuelle Fabric, utilisez la commande metal interconnections delete. Spécifiez l'UUID de la connexion virtuelle Fabric avec -i ou --id. Pour ignorer l'étape de confirmation, utilisez -f ou --force.

metal interconnections delete -i <uuid> -f

Pour supprimer une connexion virtuelle Fabric de l'API, envoyez une requête DELETE au point de terminaison /connections/{connection_id}, en spécifiant l'ID du port dans le chemin.

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{id}

L'envoi de la demande supprimera définitivement la connexion.

Demande d'une connexion virtuelle Fabric facturée par Fabric​

Utilisation du jeton de service côté Z​

Configuration de l'origine​

Gestion des connexions virtuelles Fabric​

Circuits virtuels​

Configuration de VRF​

Suppression d'une connexion virtuelle Fabric​