Connexion à la Fabric avec un jeton de service
Établissez une connexion entre vos appareils Network Edge et des destinations sur Fabric en échangeant un jeton de service Z-Side. Vous pouvez recevoir un jeton de service Z-Side d’un revendeur, d’un opérateur, d’un fournisseur de services ou d’un autre client Equinix Fabric afin que vous puissiez le créer sur son infrastructure ou son service.
Lors de la création de la connexion, vous sélectionnez le dispositif virtuel et ses paramètres de connexion, et le jeton de service fournit les détails de connexion et la configuration de l'autre côté de la connexion. Chaque connexion nécessite son propre jeton de service. Vous pouvez créer une paire de connexions à partir de vos dispositifs virtuels redondants ou de cluster avec deux jetons de service distincts.
Si vous souhaitez autoriser quelqu'un à créer une connexion À votre appareil virtuel Network Edge, vous pouvez créer et partager un jeton de service Z-Side .
Conditions préalables
- Portal
- API
-
Connectez-vous à Equinix Customer Portal et accédez au tableau de bord Network Edge.
-
Cliquez sur créer une connexion.

-
Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Pour savoir comment appeler OAuth API pour valider et authentifier vos identifiants, reportez-vous à authentification API.
-
Récupérez les informations de votre terminal Network Edge à l'aide des
/ne/v1/devicesterminaux ou/ne/v1/devices/{uuid}. Si vous vous connectez à partir de dispositifs redondants, vous avez besoin de l'UUID du dispositif principal ou secondaire. Si vous vous connectez à partir d'un dispositif de cluster, vous avez besoin de l'UUID denode0ounode1. Il ne peut y avoir qu'une seule connexion par jeton de service. Des connexions supplémentaires à des dispositifs redondants ou de cluster nécessitent des jetons de service supplémentaires. -
Récupérez votre jeton de service.
-
Si un tiers a partagé un jeton de service afin que vous puissiez vous connecter à son infrastructure ou à son service, vous avez besoin de l'UUID du jeton de service qu'il a partagé avec vous.
-
Si vous vous connectez à vos propres équipements avec un jeton de service que vous ou une autre personne de votre organisation avez créé, vous pouvez récupérer l'UUID du jeton de service à partir du
/fabric/v4/serviceTokenspoint de terminaison, ainsi que les paramètres de connexion autorisés.
-
Créer la connexion
- Portal
- API
Sur la page créer une connexion à :
-
Sur la carte se connecter à l'aide d'un jeton de service , cliquez sur saisir un jeton de service .

-
Saisissez votre jeton de service Z-Side. Vérifiez que les détails du jeton de service sont corrects et cliquez sur utiliser le jeton de service .

-
Cliquez sur suivant.
-
Dans la liste déroulante type d’équipement d’origine, sélectionnez dispositif virtuel .
-
Dans la section origine, cliquez sur périphérique virtuel .
-
Sélectionnez l'emplacement et le type de dispositif virtuel.
- Si vous vous connectez à partir d'un seul appareil, l'option de connexion unique est sélectionnée pour vous.
- Si vous vous connectez à partir de périphériques redondants ou de cluster, vous avez la possibilité de créer une connexion redondante. Dans le champ destination redondante, saisissez le jeton de service pour la deuxième connexion.
-
Sélectionnez le(s) dispositif(s) virtuel(s) et cliquez sur suivant.

-
Sur la page informations de connexion :
-
Entrez un nom de connexion. Pour les connexions redondantes, saisissez un nom pour la connexion principale dans le champ informations sur la connexion principale et un nom pour la connexion secondaire dans le champ informations sur la connexion secondaire.
-
Dans la section sélection de l'interface , choisissez de sélectionner automatiquement l'interface disponible suivante sur mon(mes) appareil(s) ou je vais sélectionner une interface.
-
(Facultatif) saisissez le numéro du bon de commande.
-
Sélectionnez une vitesse de connexion . Les options de vitesse de connexion sont prédéfinies par le jeton de service. Si vous commandez des connexions redondantes, sélectionnez à la fois une vitesse de connexion principale et une vitesse de connexion secondaire.
-
Cliquez sur suivant.

-
-
Sur la page vérifier, vérifiez les informations des sections Aperçu, Résumé de la connexion et Aperçu des tarifs. Dans la section notifications, ajoutez les adresses e-mail de tous les utilisateurs devant recevoir des notifications concernant cette connexion.

-
Cliquez sur Envoyer la commande.
Pour créer une connexion entre votre appareil virtuel et un autre emplacement réseau sur Fabric à l’aide d’un jeton de service, envoyez POSTune demande au /fabric/v4/connectionspoint final.
Définissez votre dispositif Network Edge dans l'aSideobjet, y compris :
accessPoint.typeasVDvirtualDevice.typeasEDGEvirtualDevice.uuidComme UUID de votre appareil
Indiquez votre UUID de jeton de service dans l'zSideobjet. Le jeton de service fournit toutes les autres informations nécessaires pour établir la connexion.
Exemple de requête cURL :
curl -X POST 'https://api.equinix.com/fabric/v4/connections' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"type": "EVPL_VC",
"name": "<connection_name>",
"bandwidth": <connection_speed>,
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "<virtual_device_uuid>"
},
}
},
"zSide": {
"serviceToken": {
"uuid": "<service_token_uuid>"
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>",
"<contact_email>"
]
}
]
}'
Contrôle de l'état de la connexion
- Portal
- API
Vous pouvez surveiller l'état de votre nouvelle connexion dans votre inventaire des connexions .
Utilisez le /fabric/v4/connections/{connectionId}point de terminaison API pour surveiller l'état de la connexion.