Création d’une VXC à AWS avec l’API

Cette rubrique présente la procédure API visant à créer une VXC vers un AWS, y compris la manière de rechercher les emplacements d’interconnexion cloud, de valider la connexion et de commander la VXC.

L’exemple dans cette rubrique crée une connexion VIF hébergée à AWS avec un débit de données de 500 Mbits/s. Pour parcourir cet exemple, utilisez l’URL de l’environnement de test, qui vous permet de configurer les connexions mais qui ne déploie ni ne facture les services.

Avant de commencer, obtenez un jeton d’accès valide. Pour plus d’informations, voir Création d’une clé API.

Conseil

Pour voir toutes les options relatives aux demandes utilisées dans cet exemple, rendez-vous sur https://dev.megaport.com

Pour consulter les détails sur l’emplacement du fournisseur de services cloud dans la collection Postman

Développez le dossier Locations (Emplacements) dans la navigation de gauche et cliquez sur GET Partner Megaports (OBTENIR Partenaire Megaport).
Cliquez sur Send (Envoyer) pour faire une demande GET au serveur API.
```
GET {baseUrl}/v2/dropdowns/partner/megaports
```
Cette demande renvoie toutes les interfaces que Megaport a avec les fournisseurs de services cloud. Vous pouvez effectuer une recherche en cliquant sur la loupe et en entrant un emplacement, un centre de données ou un autre paramètre spécifique dans le champ de recherche.

Le connectType indique le fournisseur de services cloud. AWS comprend “AWS” pour les VIF hébergées et “AWSHC” pour les connexions hébergées.

Vous pouvez filtrer les résultats par connectType et vxcPermitted.
```
GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=true
```
Cet exemple utilise un port dans Interxion DUB2 qui accepte les VXC (“vxcPermitted”: true) et se trouve dans la région eu-west-1.

      {
            "connectType": "AWS",
            "productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
            "vxcPermitted": true,
            "companyUid": "623cb950-abb4-4b07-b372-8cf55756c322",
            "companyName": "AWS",
            "title": "EU (Ireland) (eu-west-1)",
            "locationId": 96,
            "speed": 10000,
            "rank": 61,
            "lag_id": 2,
            "lag_primary": true,
            "aggregation_id": 54188
        },

Pour tester et valider la commande

Dans Postman, développez Cloud Connectivity > Port > AWS Direct Connect (Connectivité cloud > Port > AWS Direct Connect) dans la navigation de gauche et sélectionnez POST Validate AWS (PUBLIER Valider AWS) - Hosted VIF (VIF hébergée).
Mettez à jour le corps de la demande avec le productUid du port, le productUid du port AWS et l’ID du compte AWS.
Vous pouvez également modifier des valeurs supplémentaires, telles que le nom, le débit maximal, l’ID VLAN, les valeurs ASN, l’authKey et l’adressage IP.
Cliquez sur Send (Envoyer) pour PUBLIER la demande.
```
POST {baseUrl}/v2/networkdesign/validate
```

[
    {
        "productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7", 
        "associatedVxcs": [
            {
                "productName": "My Amazon Direct Connect",
                "rateLimit": "500",
                "aEnd": {
                    "vlan": 777
                },
                "bEnd": {
                    "productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f", 
                    "partnerConfig": {
                        "connectType": "AWS",
                        "name": "Amazon name for service",
                        "type": "private",
                        "asn": 65105,
                        "amazonAsn": 64555,
                        "ownerAccount": "312345679135",
                        "authKey": "123456",
                        "prefixes": "10.0.1.0/24",
                        "customerIpAddress": null,
                        "amazonIpAddress": null
                    }
                }
            }
        ]
    }
]

Après validation, vous êtes prêt à passer la commande VXC.

Pour commander la VXC à AWS

Copiez le corps validé de POST Validate AWS (PUBLIER Valider AWS) - Hosted VIF (VIF hébergée) et collez-le dans le corps de POST Buy AWS (PUBLIER Acheter AWS) - Hosted VIF (VIF hébergée).
Cliquez sur Send (Envoyer) pour publier la demande.
```
POST {baseUrl}/v2/networkdesign/buy
```

Voici un exemple de réponse réussie.

{
    "message": "VXC [47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e] created. ",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
        {
            "createDate": 1588868593704,
            "vxcOrderId": 42328,
            "payerMegaPortId": 68124,
            "nonPayerMegaPortId": 52786,
            "payerMegaPortName": "API Port",
            "nonPayerMegaPortName": "EU (Ireland) (eu-west-1)",
            "payerCompanyId": 2278,
            "nonPayerCompanyId": 117,
            "payerLocationId": 89,
            "nonPayerLocationId": 96,
            "salesId": null,
            "payerCompanyName": "Megaport Lab",
            "nonPayerCompanyName": "AWS",
            "payerMegaPortNsId": 138231,
            "nonPayerMegaPortNsId": 221182,
            "payerVlanId": 777,
            "nonPayerVlanId": 0,
            "payerApproverName": "Paul McGuinness",
            "payerApproverId": 12695,
            "nonPayerApproverName": "Paul McGuinness",
            "nonPayerApproverId": 12684,
            "payerApproval": 1582268553574,
            "nonPayerApproval": 1228868693614,
            "fixedTerm": true,
            "duration": 1,
            "rollover": true,
            "serviceName": "from API Port to EU (Ireland) (eu-west-1)",
            "payerStatus": "APPROVED",
            "nonPayerStatus": "APPROVED",
            "speed": 500,
            "distanceBand": "ZONE",
            "intercapPath": "",
            "awsId": null,
            "promoCode": null,
            "rateType": "MONTHLY",
            "vxcJTechnicalServiceId": 57115,
            "vxcJTechnicalServiceUid": "47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e",
            "provisionDate": 1588868593517,
            "orderType": "NEW",
            "monthlyDiscountAmount": null,
            "discountMonths": null,
            "amazonDirectConnectConfigDto": {
                "type": "private",
                "asn": 65105,
                "ownerAccount": "312345679135",
                "authKey": "123456",
                "customerIpAddress": null,
                "amazonIpAddress": null,
                "prefixes": "10.0.1.0/24",
                "name": "Amazon name for service"
            },
            "amsixConnectConfigDto": null,
            "webAirProvItem": null,
            "sdrcProvItem": null,
            "rate": null,
            "setup": null,
            "asn": null,
            "bgpPassword": null,
            "usageAlgorithm": "POST_PAID_HOURLY_SPEED_LONG_HAUL_VXC",
            "costCentre": null,
            "azureServiceKey": null,
            "oracleVirtualCircuitId": null,
            "serviceKey": null,
            "connectType": "AWS",
            "payerConfig": {},
            "nonPayerConfig": {},
            "attributeTags": {},
            "fullyApproved": true
        }
    ]
}

Le port et la VXC apparaissent désormais dans le Megaport Portal.

Vue du portail du port d’API et de la VXC

Pour cet exemple, la VIF hébergée AWS apparaîtra dans le compte du portail AWS sous Direct Connect - Virtual Interfaces (Direct Connect - Interfaces virtuelles). Le titulaire du compte peut accepter l’interface virtuelle et la connecter à une passerelle privée virtuelle ou à une passerelle Direct Connect, puis à son VPC.