Création d’un MCR avec l’API

Cette rubrique explique la procédure API pour créer un MCR, y compris comment rechercher les emplacements pour le MCR, et valider et finaliser la commande.

Pour consulter les détails sur l’emplacement du MCR dans la collection Postman

  1. Développez le dossier Locations (Emplacements) dans la navigation de gauche et cliquez sur GET locations (OBTENIR emplacements).

    Cette demande a les mêmes en-têtes Content-Type (Type de contenu) et X-Auth-Token (Jeton d’authentification X) que la demande de connexion et elle n’attend pas d’informations Parameters (Paramètres) ou Body (Corps).

  2. Cliquez sur Send (Envoyer) pour faire une demande GET.

    GET {baseUrl}/v2/locations
    

    Obtenir les emplacements

    Vérifiez que la demande a abouti en recherchant la mention Status : 200 OK et affichez la réponse dans la section Body (Corps) au format Pretty.

    La demande renvoie des centaines d’emplacements Megaport.

  3. Cliquez sur la loupe et recherchez dans la réponse un site qui inclut mcr2 dans l’objet products et qui est sur le marché américain.

    L’objet products identifie les types de produit qui sont disponibles pour l’emplacement. Un tableau mcr2 avec les vitesses MCR 2.0 disponibles n’est visible que si le l’emplacement prend en charge MCR 2.0.

    Cet exemple utilise l’emplacement CoreSite à Los Angeles.

{
            "country": "USA",
            "liveDate": 1449446400000,
            "siteCode": "lax-cs1",
            "networkRegion": "MP1",
            "address": {
                "country": "USA",
                "city": "Los Angeles",
                "street": "624 South Grand Avenue",
                "postcode": "90017",
                "suburb": null,
                "state": "CA"
            },
            "campus": "campus_deprecated",
            "latitude": 34.04791,
            "products": {
                "mcr": true,
                "mcrVersion": 2,
                "megaport": [
                    1,
                    10,
                    100
                ],
                "mcr1": [
                    100,
                    500,
                    1000,
                    2000,
                    3000,
                    4000,
                    5000
                ],
                "mcr2": [
                    1000,
                    2500,
                    5000,
                    10000
                ]
            },
            "market": "US",
            "metro": "Los Angeles",
            "name": "CoreSite LA1",
            "vRouterAvailable": true,
            "id": 60,
            "dc": {
                "name": "CoreSite",
                "id": 18
            },
            "status": "Active",
            "longitude": -118.25554,
            "ordering_message": null
        },

Pour créer un MCR, vous avez besoin de la valeur id. Dans cet exemple, l’ID de l’emplacement est 60.

Pour tester et valider la commande de MCR

  1. Dans Postman, développez Megaport Cloud Router (MCR) dans le volet de navigation de gauche et sélectionnez Validate MCR Order (Valider la commande de MCR).

  2. Mettez à jour le corps avec locationId (60), productName (le nom que vous voulez pour votre port), et portSpeed (1000, 2500, 5000 ou 10 000 Mbits/s) et cliquez sur Send (Envoyer).

    POST {baseUrl}/v2/networkdesign/validate
    
[
  {
    "locationId": 60,
    "productName": "API Test MCR",
    "productType": "MCR2",
    "portSpeed": 5000,
    "config": {
      "mcrAsn": 64496
    }
  }
]

Une réponse réussie passe la validation et a un statut 200 OK. La réponse comprend également des détails sur la tarification du service.

{
    "message": "Validation passed",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
        {
            "price": {
                "hourlySetup": 0,
                "dailySetup": 0,
                "monthlySetup": 0,
                "hourlyRate": 0,
                "dailyRate": 0,
                "monthlyRate": 1200.00,
                "fixedRecurringCharge": 0,
                "postPaidBaseRate": "no base rate",
                "longHaulMbpsRate": 0,
                "mbpsRate": 5.000000000,
                "currency": "USD",
                "key": "no key",
                "productType": "MCR2",
                "empty": false
            },
            "serviceName": "API MCR",
            "productType": "MEGAPORT",
            "productUid": "34fcd3b6-b2c8-4b39-8d99-b59f0c488717",
            "string": "Los Angeles"
        }
    ]
}

Pour commander le MCR validé

  1. Avec une demande de MCR validée et des informations de coût révisées, copiez le corps de POST Validate MCR Order (PUBLIER Valider la commande de MCR) et collez-le dans le corps de POST Buy MCR (PUBLIER Acheter le MCR).

    Important

    Si vous passez cet appel sur api.megaport.com, votre compte sera débité du service. Vous pouvez également utiliser l’API dans l’environnement de test sans frais, comme dans ces exemples.

  2. Envoyez la demande.

    Ce résultat montre une réponse réussie.

{
    "message": "MCR2 [b7d93096-0782-478c-8382-ba10a1c0973a] created. ",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
        {
            "serviceName": "API MCR",
            "name": "API MCR",
            "secondaryName": null,
            "technicalServiceId": 60670,
            "technicalServiceUid": "b7d93096-0782-478c-8382-ba10a1c0973a",
            "requestedDate": 1593554373089,
            "configuredDate": null,
            "currentEstimatedDelivery": null,
            "companyName": "Kunakin",
            "companyId": 31156,
            "aggregationId": null,
            "lagPrimary": false,
            "billingContactName": null,
            "billingContactId": null,
            "adminContactName": null,
            "adminContactId": null,
            "technicalContactName": null,
            "technicalContactId": null,
            "salesName": null,
            "salesId": null,
            "billableId": 59875,
            "billableUsageAlgorithm": "POST_PAID_HOURLY_SPEED_MCR2",
            "productType": "MCR2",
            "provisioningStatus": "DEPLOYABLE",
            "inAdvanceBillingStatus": "NOT_ACTIVATED",
            "provisioningItems": [],
            "tags": [],
            "vxcDistanceBand": null,
            "intercapPath": null,
            "marketplaceVisibility": true,
            "vxcPermitted": true,
            "vxcAutoApproval": false,
            "createDate": 1593554373089,
            "terminationDate": null,
            "contractStartDate": 1593525600000,
            "contractTermMonths": 1,
            "rateType": "MONTHLY",
            "trialAgreement": false,
            "payerCompanyId": null,
            "nonPayerCompanyId": null,
            "minimumSpeed": null,
            "maximumSpeed": null,
            "rateLimit": 5000,
            "errorMessage": null,
            "market": "USA",
            "accountManager": null,
            "promptUid": null,
            "components": [],
            "attributes": [],
            "aLocation": null,
            "bLocation": null,
            "aLocationId": null,
            "bLocationId": null,
            "attributeTags": {},
            "createdBy":  "a51cc1c6-95a0-48c7-a5a0-e49d77a6c536",
            "buyoutPort": false,
            "virtual": true,
            "locked": false,
            "adminLocked": false
        }
    ]
}

Le nouveau MCR apparaît maintenant dans votre environnement de travail, portal.megaport.com ou portal-staging.megaport.com.

Nouvelle API MCR

Conseil

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

L’étape suivante consiste à créer des VXC pour ce MCR.


Dernière mise à jour: