Connexions virtuelles du Metal Billed Fabric

Les connexions virtuelles Fabric facturées par Metal vous permettent d'établir une connexion virtuelle de couche 2 depuis Equinix Metal™ vers d'autres fournisseurs de services cloud (CSP) sur Fabric dans la même zone métropolitaine, sans nécessiter de périphérique Network Edge . Vous aurez toujours besoin d'un compte sur le portail Equinix Fabric pour utiliser le jeton de service côté A, mais vous n'avez pas besoin d'un compte de facturation Equinix Fabric .

Informations système

• Chaque connexion Virtual 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 ports Virtual Fabric ont une bande passante maximale de 10 Gbit/s.

• Les ports Virtual Fabric prennent en charge une unité de transmission maximale (MTU) jusqu'à 9 000 octets et des trames Ethernet jumbo.

Origines et destinations

Origin	Destination	Supported
Facturation Metal Fabric VC	N'importe quel port physique sur le réseau (à l'extérieur d'un [Profil de service)	Oui
VC Fabric facturé en métal	Tout profil de service de couche 2 (https://docs.equinix.com/en-us/Content/Interconnection/Fabric/service-profiles/Fabric-service%20profiles.htm) sur un port Fabric physique, généralement un fournisseur de services infonuagiques	Oui
Infrastructure virtuelle à facturation métallique	Périphérique virtuel (appareil réseau) ou [profil de service sur un périphérique virtuel	Non
Infrastructure d'informatique en nuage Metal Billed Fabric VC	Equinix Metal comme fournisseur de services infonuagiques de destination	Non

Bande passante et tarification

Les frais d'utilisation des connexions virtuelles Fabric facturées par Metal sont mesurés et facturés par Equinix Metal, et seront inclus dans vos factures mensuelles. Toute utilisation est horaire, le tarif étant déterminé par le débit maximal choisi pour la connexion. Vos options de débit maximal sont:

• 50 Mbps
• 200 Mbps
• 500 Mbps
• 1 Gbps
• 2 Gbps
• 5 Gbps
• 10 Gbps

Remarque: vous choisissez une vitesse maximale, car il est possible que le fournisseur d'accès auquel vous vous connectez propose des options de vitesse de connexion supplémentaires. Sur le portail Fabric, vous pourrez choisir une vitesse allant jusqu'à la vitesse maximale commandée via Equinix Metal.

Demande de connexion virtuelle Fabric facturée en Metal

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 Factory Billed.

• Sélectionnez l'emplacement de la nouvelle connexion dans le menu déroulant. Sélectionnez la zone métropolitaine où se trouvent votre infrastructure Equinix Metal et celle du CSP auquel vous vous connectez sur Fabric: ces interconnexions sont liées à la zone métropolitaine.
• Donnez un nom à votre connexion.
• Choisissez si vous souhaitez un ensemble de ports redondants. Les ports redondants sont fortement recommandés. La sélection d'un seul port peut entraîner des temps d'arrêt importants en raison de pannes planifiées ou non.
• Définissez la vitesse de connexion en la sélectionnant dans le menu déroulant. Remarque: la vitesse ne peut pas être modifiée après l'émission d'un jeton de service. Une nouvelle demande et un nouveau jeton de service sont nécessaires pour modifier la vitesse.

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.

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 VC Fabric à facturation métallique 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 Metal-billed Fabric Virtual Connection. Set the value to a_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": "a_side",
    "redundancy": "<redundant>",
    "speed": "<string>",
    "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) - Select the metro where both your Equinix Metal infrastructure and the CSP destination on Fabric is: these interconnections are metro-bound.
• "type" (required) - This parameter is required when requesting a Metal-billed Fabric Virtual Connection. Set the value to "shared".
• "service_token_type" (required) - This parameter is required when requesting a Metal-billed Fabric Virtual Connection. Set the value to a_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 crée le Fabric VC sur Equinix Medal et génère vos jetons Fabric. 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-13e5b975058c",
    “role”: "primary",
    “state”: "inactive",
        “max_allowed_speed”: 50000000,
    “service_token_type”: "a_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}"

Échange de votre jeton de service côté A

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

Sélectionnez la destination de la connexion, qui peut être un fournisseur de services cloud comme AWS ou Azure, ou un port Fabric dont vous êtes propriétaire. Equinix Metal n'est pas pris en charge comme destination.

Si vous vous connectez à un fournisseur de services infonuagiques, sélectionnez Un fournisseur de services et choisissez celui que vous recherchez.

OU

Si vous vous connectez à votre propre port Fabric, sélectionnez Mes propres ressources et Connecter mes ressources en tant que ligne E.

Une fois votre destination sélectionnée, utilisez vos jetons de service pour définir Equinix Metal comme origine de la connexion. Sélectionnez « Jeton de service » et entrez le jeton dans le champ prévu à cet effet. Les informations relatives au port d'origine seront automatiquement remplies après la saisie du jeton.

Si vous vous connectez à un fournisseur de services cloud, celui-ci peut proposer des options de redondance qui vous permettent d'échanger les deux jetons à la fois.

Sinon, vous devrez répéter ce processus pour chaque jeton.

OU

Si vous vous connectez à votre propre port Fabric, les informations du port d'origine seront également filtrées automatiquement et vous pourrez voir vos options pour sélectionner votre port Fabric de destination.

Les options de destination seront filtrées selon la métropole que vous avez demandée sur Equinix Metal. Sélectionnez celle à laquelle vous souhaitez vous connecter, puis cliquez sur Suivant.

Donnez un nom convivial au circuit virtuel de connexion et saisissez les informations requises par le fournisseur de services auquel vous vous connectez, comme votre identifiant de compte AWS. Définissez la vitesse de connexion jusqu'à la limite définie sur Equinix Metal.

Cliquez sur Suivant pour examiner vos choix, et lorsque vous serez prêt à passer la commande, cliquez sur Soumettre la commande.

Remarque: après avoir soumis la commande, vous devrez peut-être également vous connecter au compte que vous utilisez pour gérer le fournisseur de services auquel vous vous connectez, afin d'approuver la connexion depuis Equinix Metal et Fabric.

L'utilisation de votre jeton de service A-side et la configuration de votre connexion dans Fabric lancent une tâche en arrière-plan sur Equinix Metal pour finaliser la configuration et l'activation. Cela prend généralement moins de 15 minutes.

Si vous avez reçu deux jetons pour une connexion redondante et que vous n'avez pas pu utiliser les deux jetons lors de la connexion au CSP, 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.

Une fois que vous avez utilisé votre jeton de service sur Fabric et que l'activation est terminée, la facturation horaire commencera.

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. La facturation commencera lorsque le statut de la connexion virtuelle Fabric passera à 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 permet d'afficher l'état et la configuration du port.

CLI

Dressez la liste de toutes les interconnexions de votre projet, y compris les connexions virtuelles de fabrication à facturation métallique, à 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 à facturation métallique, 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 Metal Billed Fabric VC, 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 Metal côté Equinix Metal supprime automatiquement la connexion dans Fabric. Si vous la supprimez depuis le 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 auprès du fournisseur de services cloud de destination. Cette opération avant la suppression de 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. L'utilisation et la facturation cesseront une fois la connexion Metal Facturée supprimée.