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

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.

• 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.

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.

CLI

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 (required) - Your Project's UUID.
• -r, --redundancy - Select primary or redundant. If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• -T, --service-token-type (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to z_side.
• -t, --type (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• --vlan" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The vlan option is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• --vrfs - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The vrfs option is required if you are using VRFs. If you are using VLANs, this field is NOT required.

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.

API

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" (required) - The name of your new Fabric Virtual Connection.
• "description" (optional) - A user-friendly description for your Fabric Virtual Connection.
• "contact_email" - The preferred email used for communication and notifications about the Interconnection. Required when using a Project API key. Optional and defaults to your user email address when using a User API key.
• "metro" (required) - The metro where the Fabric Virtual Connection lives.
• "type" (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• "service_token_type" (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to z_side.
• "redundancy" (required) - Select "primary" or "redundant". If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• "vlans" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The "vlans" field is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• "vrfs" - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The "vrfs" field is required if you are using VRFs. If you are using VLANs, this field is NOT required.

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.

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.

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

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.

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.

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.

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 .

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.

Gestion des connexions virtuelles Fabric

Console

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.

• 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.

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

CLI

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 (required) - The UUID of the interconnection.
• -e, --contactEmail - Adds or updates the email contact for the Fabric Virtual Connection.
• -n, --name - Updates the name.
• -d, --description - Adds or updates the description.
• -r, --redundancy - Updating to primary will remove a secondary port, while updating to redundant will add a secondary port.
• -t, --tags - Adds or updates the tags.

API

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.

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.

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" - Adds or updates the email contact for the Fabric Virtual Connection.
• "name" - Updates the name.
• "description" - Adds or updates the description.
• "redundancy" - Updating to "primary" will remove a secondary port, while updating to "redundant" will add a secondary port.
• "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

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.

API

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}.

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.

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

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

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

CLI

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

API

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.