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

Les connexions virtuelles Fabric Billed sont utilisées pour établir une connexion entre vos ports Fabric ou vos dispositifs Network Edge et Equinix Metal, que ce soit au sein d'un même métro ou d'un métro à l'autre. Les cas d'utilisation comprennent l'utilisation d'un périphérique Network Edge comme routeur pour vos services Equinix Metal ou la connexion d'Equinix Metal à un fournisseur de services en nuage à travers les métropoles. Tous les frais d'utilisation, de Network Edge et de dispositif virtuel apparaissent sur votre compte Equinix Fabric.

Remarque : cette fonctionnalité remplace les Shared Ports pour les utilisateurs précédents des dispositifs Equinix Fabric et Network Edge avec leur infrastructure Equinix Metal. Les interconnexions de ports partagés existantes continueront à fonctionner et seront indiquées dans le portail et l'API comme Legacy.

Informations sur le système

• Chaque connexion virtuelle Fabric peut être un port unique ou un ensemble de ports redondants. Les ports redondants sont recommandés pour assurer une certaine haute disponibilité. Avec un port unique, il n'y a pas de garantie de disponibilité.

• Chaque connexion virtuelle Fabric est livrée avec un circuit virtuel unique auquel vous pouvez attacher 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 attacher qu'un VLAN à un circuit virtuel, et un circuit virtuel à un VLAN. Le même VLAN ne peut pas être connecté à deux circuits virtuels ou plus. Par conséquent, si vous concevez une haute disponibilité avec des ports primaires et secondaires, vous aurez besoin d'un VLAN pour chacun d'entre eux et vous devrez mettre en place un routage inter-vlan ou une autre prise en compte de l'application de la couche 3.

• Pour le routage, les connexions virtuelles de la Fabric peuvent utiliser Routage et transfert virtuels. Pour plus d'informations, reportez-vous à la page VRF for Interconnections.

• Les connexions virtuelles Fabric ont une bande passante maximale de 10 Gbps.

• La connexion virtuelle Fabric prend en charge une unité de transmission maximale (MTU) de 9000 octets et des trames Ethernet jumbo.

Origines et destinations

Origin	Destination	Supported
Tout port physique sur la Fabric (pas sur un [profil de service)	Fabric Billed Fabric VC	Yes Single Virtual Device ([not on a Service Profile)

Demande d'une connexion virtuelle Fabric Billed

Console

Pour demander une connexion virtuelle Fabric, ouvrez la page Interconnexions du projet. Cliquez sur + Request New Interconnection.

Dans la section Interconnection Type, 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. Vous voudrez choisir le métro où vivent vos serveurs et VLAN Equinix Metal, ou l'endroit 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 primaire et d'un port secondaire avec un circuit virtuel chacun pour y attacher deux VLAN, ce qui vous donne un certain degré de redondance et de haute disponibilité.
• La Vitesse maximale d'interconnexion est réglée sur le maximum par défaut de 10 Gbps. Vous sélectionnerez la vitesse réelle de la connexion lorsque vous échangerez votre jeton de service dans le portail Fabric.

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

• Si vous n'utilisez que des VLAN, sélectionnez le ou les VLAN qui seront connectés à vos ports. Les VLAN doivent se trouver dans le même projet et le même emplacement que votre VC Fabric. Si vous n'avez aucun VLAN éligible, vous pouvez cliquer sur + Create a VLAN pour les créer. Le même VLAN ne peut pas être connecté à deux circuits virtuels ou plus, donc si vous demandez des ports redondants, sélectionnez un VLAN pour chacun d'entre eux. Remarque: Vous ne pourrez pas mettre à jour ou modifier le VLAN après la création du VC Fabric.

• Si vous utilisez le VRF, sélectionnez le VRF pour vos ports. Vous trouverez de la documentation supplémentaire sur la page VRF for Interconnections.

Consultez le résumé de votre demande. Cliquez sur Submit Request pour recevoir vos jetons de service z-side.

Les jetons expirent dans les 7 jours. Vous devriez également recevoir un courriel contenant vos jetons et les informations relatives à leur expiration. Sur la page Interconnexions, votre connexion virtuelle Fabric nouvellement demandée sera répertoriée dans l'onglet Demandes en attente.

CLI

Pour demander un VC Fabric facturé dans la CLI, 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 s'excluent mutuellement et au moins l'un ou l'autre est requis.

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

API

Pour demander une connexion via l'API, envoyez une requête POST au point de terminaison /projects/{project_id}/connections. Si vous attachez des VLAN à ce VC Fabric, utilisez le paramètre "vlans" dans le corps de la requête. Si vous utilisez le 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 s'excluent mutuellement et au moins l'un ou l'autre est requis.

L'envoi de la demande génère vos jetons de service côté z. Les jetons sont inclus dans la demande. Les 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 dans les 7 jours. Vous devriez également recevoir un courriel contenant vos jetons de service et les informations relatives à leur expiration. Vous pouvez vérifier votre demande et récupérer les jetons pendant cette fenêtre en envoyant une demande 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}"

Échange du jeton de service Z-side

Pour échanger votre jeton, connectez-vous au portail Equinix Fabric et dans le menu déroulant Connections, cliquez sur Create a Connection.

Sous Frequent Connections, sélectionnez la tuile Connect using a Service Token, puis cliquez sur Enter a Service Token.

Dans la boîte de dialogue, collez votre jeton dans le champ Enter Service Token et cliquez sur Validate.

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

Connexions anciennes - Si vous avez déjà utilisé des Shared Ports sur Equinix Metal, vous avez peut-être utilisé le champ Fabric Token pour échanger votre jeton et configurer votre connexion. Si vous avez des connexions existantes, elles continueront à fonctionner comme prévu. Si vous avez des jetons anciens non échangés, il n'est plus possible d'échanger ces jetons sur Equinix Fabric. Vous devrez demander de nouveaux jetons de service et utiliser les nouvelles étapes pour les échanger dans la Fabric.

Configuration de l'origine

Vous pouvez maintenant continuer à configurer votre connexion dans le portail Fabric. Comme vous avez échangé un jeton de service préconfiguré, Equinix Metal sera automatiquement défini comme destination de la connexion et vous choisirez l'origine.

Commencez par sélectionner l'emplacement de l'origine de la connexion. Il s'agit le plus souvent d'un dispositif virtuel, mais il peut également s'agir de l'un de vos propres ports Equinix Fabric. Le dispositif virtuel ou le port peut se trouver dans n'importe quel métro.

Si vous utilisez un appareil virtuel, sélectionnez le type d'appareil et le type de connexion. Actuellement, les dispositifs redondants et les groupes ne sont pas pris en charge.

Sur la page Connection Details (Détails de la connexion), donnez à votre connexion virtuelle un nom convivial, indiquez les interfaces du dispositif virtuel auxquelles se connecter (si nécessaire) et indiquez un numéro de bon de commande si votre organisation en a besoin à des fins de facturation. Le VLAN côté z est attribué automatiquement par le jeton de service et n'a pas besoin de correspondre à vos ID de VLAN sur Equinix Metal.

Ensuite, définissez la vitesse de la connexion. Equinix Metal fixe la vitesse maximale pour les connexions virtuelles Fabric - Fabric Billed à 10 Gbps. Choisissez parmi les options de vitesse et de tarification de la Fabric.

La dernière page est une page de révision, où vous pouvez revoir vos choix et revenir en arrière pour apporter des modifications. Lorsque vous êtes prêt à passer la commande, cliquez sur Submit Order. Cela lance un processus d'établissement de connexion entre Fabric et Equinix Connect en arrière-plan, qui peut prendre jusqu'à 10 minutes.

Si vous avez reçu deux jetons pour une connexion redondante, veillez à répéter la procédure pour échanger votre deuxième jeton.

Si vous avez besoin de récupérer les tokens, ils sont disponibles dans l'onglet Interconnection Request. Cliquez sur Gestion sur l'Interconnexion pour laquelle vous souhaitez obtenir les jetons.

Gestion des connexions virtuelles de la 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 l'état Active.

• Les connexions virtuelles Fabric facturées ont le type Fabric Billed.
• Metal Billed Fabric Les connexions virtuelles ont le type Metal Billed.
• Les interconnexions qui ont été configurées en tant que Ports partagés sont indiquées avec le type Legacy.

Notez que les ports dédiés sont gérés au niveau de l'organisation, donc s'il y a des ports dédiés dans votre organisation, ils apparaîtront également dans la section Ports dédiés.

En cliquant sur le nom de l'interconnexion, vous accédez à sa page Overview, qui contient une vue détaillée ainsi qu'un résumé des configurations du port primaire et du port secondaire.

Cliquez sur Primary Port ou Secondary Port pour afficher l'état et la configuration du port.

CLI

Répertoriez toutes les interconnexions de votre projet, y compris les connexions virtuelles de la Fabric facturées, à l'aide de la commande metal interconnections get. Spécifiez 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 l'organisation. S'il existe des ports dédiés dans votre organisation, 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 facultatifs 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 répertorier toutes les interconnexions d'un projet, envoyez une requête GET au point de terminaison /organizations/{organization_id}/connections, en filtrant la réponse vers 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 l'organisation. S'il existe des ports dédiés dans votre organisation, 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 VC Fabric Billed, 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 VC Fabric facturé en envoyant une requête PUT au point de terminaison /connections/{connection_id}. Spécifiez ce que vous souhaitez modifier dans le corps de la demande. Tous les champs sont facultatifs 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 sur les ports de vos interconnexions.

Pour obtenir une liste des ports d'un VC Fabric facturé, envoyez une requête GET au point d'extrémité /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 les détails d'un 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, primaire et secondaire, dispose d'un circuit virtuel unique auquel un VLAN ou un VRF peut être attaché.

Si vous utilisez des VLAN, vos circuits virtuels seront attachés aux VLAN que vous avez spécifiés. Ils ne peuvent pas être modifiés ou changés. Si vous avez besoin d'un VC Fabric avec un VLAN différent, vous devez démonter et recréer le VC Fabric.

Remarque : si vous avez déjà ajouté, supprimé ou modifié des VLAN sur un circuit virtuel via la console ou l'API, ces options ne sont plus disponibles après 29 février 2024. Les demandes de mise à jour (PUT) adressées au point de terminaison /virtual-circuits/{id} comporteront un en-tête sunset dans leur réponse. Il existe une exception uniquement pour les VC Fabric provisionnés avant 1 mars 2024 qui sont Waiting on customer VLAN.

Si vous utilisez VRF, vos circuits virtuels auront pour statut Waiting on Peering Details.

Configuration de VRF

Console

Si vous utilisez VRF sur vos circuits virtuels, cliquez sur le menu à trois barres pour ouvrir le volet Manage Peering Details. Remplissez les champs avec les informations demandées.

C'est ici que vous indiquez 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 Update Virtual Circuit.

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 de peering pour votre VRF. Envoyez une requête PUT au point d'extrémité /virtual-circuits/{vrf_virtual_circuit_id}.

C'est ici que vous indiquez 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 permanente. Lorsque vous supprimez la connexion, tous les VLAN attachés sont détachés et le trafic entre la Fabric et vos serveurs est coupé.

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

Veillez à arrêter le trafic avant la suppression et à nettoyer toutes les ressources associées à la connexion. En procédant ainsi avant de supprimer la connexion à partir du portail Metal ou Fabric, vous vous assurez que la connexion sera entièrement supprimée et que les frais de facturation seront arrêtés.

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 Delete Interconnection 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 sauter l'étape de confirmation, utilisez -f ou --force.

metal interconnections delete -i <uuid> -f

API

Pour supprimer une connexion virtuelle Fabric à partir 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 d'accès.

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.