Création d’un VXC entre un Port et Microsoft Azure avec l’API
Ce sujet décrit la procédure API pour créer un VXC d’un Port vers Microsoft Azure ExpressRoute, y compris comment rechercher les emplacements des ports Azure et commander les VXCs.
Le déploiement de Port vers Azure inclut ces tâches:
-
Configurer un circuit ExpressRoute dans la console Azure
Lors du déploiement, vous obtenez une clé de service. La clé de service est liée aux ports assignés dans Azure. Lorsque vous validez une clé de service, la réponse montre les ports primaires et secondaires assignés dans Azure. Vous pouvez utiliser la clé de service deux fois - une fois pour se connecter au port primaire et une deuxième fois pour créer une autre connexion au port secondaire.
Pour plus d’informations, consultez le sujet d’aide de Microsoft Tutoriel: Créer et modifier un circuit ExpressRoute. -
Avec la clé de service, créez et déployez vos VXCs depuis le Megaport Portal
Cette étape utilise l’API – les autres étapes se déroulent en dehors de Megaport dans l’environnement Azure.
-
Avec un VXC déployé sur votre circuit, configurez le peering dans le portail Azure
Les informations de peering sont partagées entre les circuits primaires et secondaires, tout comme le VLAN interne assigné au pair.
Pour plus d’informations, consultez le sujet d’aide de Microsoft Créer et modifier le peering pour un circuit ExpressRoute. -
Configurer l’équipement sur site client (CPE)
Avant de commencer, obtenez un jeton d’accès valide. Pour plus d’informations, consultez Création d’une clé API.
Valider la clé de service
Lorsque vous utilisez l’API pour valider une clé de service Azure, la réponse inclut les détails ExpressRoute des ports et pairs associés. Vous avez besoin des détails du port pour créer les VXCs.
Pour valider la clé de service dans la collection Postman
-
Dans Postman, développez Cloud Connectivity > Port > Azure dans la navigation de gauche et sélectionnez GET Look Up Azure Service Key.
-
Ajoutez la clé de service à l’endpoint.
-
Cliquez sur Send pour effectuer une requête GET au serveur API.
GET {baseUrl}/v2/secure/azure/{service_key}
Voici un exemple de réponse pour une nouvelle clé (sans VXCs configurés):
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
La valeur megaports:vxc est nulle pour les deux Ports, ce qui indique qu’ils sont disponibles pour de nouveaux VXC.
Pour plus d’informations sur chaque champ de la réponse, consultez Champs de la réponse API de clé de service Azure.
Créer et déployer les VXC
Avec les détails de la clé de service, créez un VXC vers le port principal et un autre VXC vers le port secondaire.
Pour créer les VXC
-
Sélectionnez POST Create VXC to Azure (v3).
Conseil
Pour tester votre requête avant de passer la commande et voir les détails de tarification, vous pouvez utiliser:
POST {baseUrl}/v3/networkdesign/validate -
Mettez à jour le corps (Body) de la requête avec le
productUiddu Port, le nom du VXC, leproductUiddu port Azure principal, et la clé de service. La vitesse maximale (rateLimit) est définie dans la valeur de bande passante de la réponse de la clé de service. Dans ce cas, elle est de 200. -
Cliquez sur Send pour envoyer la requête.
POST {baseUrl}/v3/networkdesign/buy
[
{
"productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID de votre Megaport (A-End)
"associatedVxcs": [
{
"productName": "Primary Azure VXC",
"rateLimit": 200,
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 102
},
"bEnd": {
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008", //retrieved port UID de la recherche de clé de service Azure
"partnerConfig": {
"connectType": "AZURE",
"serviceKey": "3e2480b2-b4d5-424b-976a-7b0de65a1b62" //clé de service de la réponse de recherche
}
}
}
]
}
]
Une fois que vous avez configuré vos VXC principaux et secondaires vers les ports Azure, une nouvelle recherche de clé de service affiche les VXC associés aux ports Azure. Les VXC sont identifiés par un numéro d’ID (megaports:vxc).
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60621,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60622,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
Pour compléter la configuration, configurez le peering dans le portail Azure et configurez vos appareils CPE.