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

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

Le déploiement du MCR vers Azure comprend ces tâches :

  1. Installez un circuit ExpressRoute dans la console Azure.
    Lors du déploiement, vous obtenez une clé de service. Lorsque vous validez une clé de service, des ports primaires et secondaires vous sont présentés et vous pouvez choisir le port de connexion. Vous pouvez utiliser la clé une seconde fois et créer une autre connexion au port inutilisé.

    Pour plus de détails, voir la rubrique d’aide de Microsoft Tutoriel : Création et modification d’un circuit ExpressRoute.

  2. Avec la clé de service, créez et déployez une VXC.

    Dans le cadre de la configuration VXC, vous pouvez choisir le type de peering. Le type de peering peut être soit privé, soit Microsoft.

    Un type de peering défini entraîne un peering configuré automatiquement avec des pairs appariés du côté Azure et du côté Megaport et un système déployé avec une configuration de travail connue. Vous pouvez modifier la configuration une fois qu’elle a été déployée.

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.

    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": []
    }
}

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

Commander une VXC avec options de peering

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. Veillez à sélectionner un MCR dans la même région que les ports Azure à partir de la demande de recherche de clé de service.

Si vous spécifiez le type de peering dans la requête API pour la VXC, Megaport configurera l’adressage IP et les détails BGP à la fois du côté MCR et du côté Azure pour assurer une configuration BGP fonctionnelle.

Pour spécifier le type de peering, ajoutez un type de peering au tableau des pairs dans la section partnerConfig. S’il n’existe aucun tableau des pairs, les pairs sont récupérés sur Azure. Si les pairs ne sont pas spécifiés lors de la création de la VXC et qu’il n’y a pas de pairs dans Azure (ce qui est normalement le cas pour les nouvelles clés de service), le peering MCR ne sera pas autoconfiguré.

Le MCR crée un VLAN pour chaque type de peering configuré. Si les options de peering privé et Microsoft sont toutes deux spécifiées, le MCR configure deux VLAN internes.

Remarque

Les types de peering sont mémorisés et ne peuvent pas être modifiés si une clé a été utilisée auparavant.

Pour commander la VXC

POST {baseUrl}/v2/networkdesign/buy

Conseil

Pour tester votre demande avant de commander, vous pouvez utiliser : POST {baseUrl}/v2/networkdesign/validate

Mettez à jour le corps de la demande avec le productUiddu MCR, le nom de la VXC, le productUid du port Azure et la clé de service. Inclure l’option de peering appropriée. 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.

Le VLAN Azure (si spécifié) est le VLAN de la balise extérieure pour Q-in-Q. Si vous ne spécifiez pas le VLAN, il sera autoprovisionné.

Pour utiliser une clé Azure avec option de peering privé, utilisez ce modèle :

 [
     {
        "productUid": "{{mcrid}}",
        "associatedVxcs": [
            {
                "productName": "Azure Primary VXC",
                "rateLimit": 200,
                "aEnd": {
                    "vlan": 0
                },
                "bEnd": {
                    "productUid": "{{azurepuid}}",
                    "vlan": "{{azurevlan}}",
                    "partnerConfig" : {
                        "connectType": "AZURE",
                        "serviceKey": "{{azurekey}}",
                        "peers": [{"type": "private"}]
                    }
                }
            }
        ]
    }
]

Pour le peering Microsoft, utilisez cette ligne pour les pairs :

          "peers":[{"type":"microsoft"}]

Pour le peering Microsoft et le peering privé, utilisez cette ligne :

          "peers":[{"type":"microsoft"}, {"type": "private"}]

Après avoir créé une VXC pour le port Azure primaire, créez une autre VXC pour vous connecter au productUid du port Azure secondaire (modifiez le productName et le bEnd: productUid).

Réponse configurée

Lorsque vous créez les VXC avec peering, une autre demande de validation de clé de service affiche la configuration complète.

{
    "message": "Successful lookup",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": {
        "managed": true,
        "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": 60574,
                "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": 60575,
                "port": 16108,
                "companyName": "Azure ExpressRoute",
                "locationId": 67,
                "productId": 16108,
                "type": "secondary",
                "companyId": 1475
            }
        ],
        "peers": [
            {
                "peer_asn": 133937,
                "shared_key": null,
                "primary_subnet": "169.254.167.176/30",
                "secondary_subnet": "169.254.167.180/30",
                "vlan": 100,
                "type": "private"
            },
            {
                "peer_asn": 133937,
                "shared_key": null,
                "prefixes": "117.18.81.116/30,117.18.81.120/30",
                "primary_subnet": "117.18.81.116/30",
                "secondary_subnet": "117.18.81.120/30",
                "vlan": 200,
                "type": "microsoft"
            }
        ]
    }
}

Dernière mise à jour: