Création d’une VXC entre un port et Microsoft Azure avec l’API

Cette rubrique présente la procédure API visant à créer une VXC entre un port et Microsoft Azure ExpressRoute, y compris la manière de rechercher les emplacements de port Azure et de commander les VXC.

Le déploiement du port à Azure comprend ces tâches :

Installez 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 attribués dans Azure. Lorsque vous validez une clé de service, la réponse indique les ports primaire et secondaire attribués dans Azure. Vous pouvez utiliser la clé de service deux fois - , une fois pour vous connecter au port primaire et une seconde fois pour créer une autre connexion au port secondaire.
Pour plus de détails, voir la rubrique d’aide de Microsoft Tutoriel : Création et modification d’un circuit ExpressRoute.
Avec la clé de service, créez et déployez vos VXC à partir du Megaport Portal.
Cette étape utilise l’API – les autres étapes ont lieu en dehors de Megaport dans l’environnement Azure.
Avec une VXC déployée sur votre circuit, configurez le peering dans le portail Azure.
Les informations de peering sont partagées entre les circuits primaire et secondaire, tout comme le VLAN interne attribué au pair.
Pour plus de détails, voir la rubrique d’aide de Microsoft Créer et modifier le peering d’un circuit ExpressRoute.
Configurez le dispositif d’équipement dans les locaux du client (CPE).

Avant de commencer, obtenez un jeton d’accès valide. Pour plus d’informations, voir 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 comprend les détails ExpressRoute des ports et des pairs associés. Vous avez besoin des détails du port pour créer les VXC.

Pour valider la clé de service dans la collection Postman

Dans Postman, développez Cloud Connectivity > Port > Azure (Connectivité Cloud > Port > Azure) dans le volet de navigation de gauche et sélectionnez GET Look Up Azure Service Key (OBTENIR Rechercher la clé de service Azure).
Ajoutez la clé de service au point de terminaison.
Cliquez sur Send (Envoyer) pour faire une demande GET au serveur API.
```
GET {baseUrl}/v2/secure/azure/{service_key}
```

Ceci est un exemple de réponse pour une nouvelle clé (sans VXC configurée).

{
    "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 nouvelles VXC.

Pour plus de détails sur chaque champ de réponse, voir Champs de réponse de la clé de service Azure.

Créer les VXC

Avec les détails de la clé de service, créez une VXC pour le port principal et une autre VXC pour le port secondaire.

Pour créer les VXC

Sélectionnez POST Créer VXC sur Azure (PUBLIER Créer VXC dans Azure).

Conseil

Pour tester votre demande avant de commander et voir les détails des prix, vous pouvez utiliser : POST {API Server URL}/v2/networkdesign/validate
Mettez à jour le corps de la demande avec le productUid du port, le nom de la VXC, le productUid du port Azure primaire 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 le cas présent, il s’agit de 200.
Cliquez sur Send (Envoyer) pour publier la demande.
```
POST {baseUrl}/v2/networkdesign/buy
```

[
    {
        "productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID of your Megaport (A End)
        "associatedVxcs": [
            {
                "productName": "Primary Azure VXC",
                "rateLimit": 200,
                "aEnd": {
                    "vlan": 102
                },
                "bEnd": {
                    "productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008", //retrieved port UID from the Azure service key lookup
                    "partnerConfig" : {
                        "connectType": "AZURE",
                        "serviceKey": "3e2480b2-b4d5-424b-976a-7b0de65a1b62" //service key from lookup response
                    }
                }
            }
        ]
    }
]

Lorsque vous avez configuré vos VXC primaire et secondaire sur les ports Azure, une autre recherche de clé de service montre les VXC associées aux ports Azure. Les VXC sont identifiées par un numéro d’identification (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 dispositifs CPE.

Dernière mise à jour: 2024-02-12