Erstellen eines MCR mit der API
Dieses Thema beschreibt das API-Verfahren zum Erstellen eines MCR, einschließlich wie Sie Standorte für den MCR nachschlagen sowie die Bestellung validieren und abschließen.
Bevor Sie beginnen, beschaffen Sie ein gültiges Access Token. Weitere Informationen finden Sie unter Erstellen eines API-Schlüssels.
So rufen Sie MCR-Standortdetails in der Postman-Collection ab
-
Erweitern Sie den Ordner Locations in der linken Navigation und klicken Sie auf GET Locations (v3).
Diese Anfrage erwartet keine Parameter- oder Body-Informationen. -
Klicken Sie auf Send, um eine GET-Anfrage zu senden.
GET {baseUrl}/v3/locations
Stellen Sie sicher, dass die Anfrage erfolgreich war, indem Sie nach Status: 200 OK suchen, und zeigen Sie die Antwort im Bereich Body im Format Pretty an.
Die Anfrage gibt Hunderte von Megaport-Standorten zurück.
-
Klicken Sie auf die Lupe und durchsuchen Sie die Antwort nach einem Standort, der
mcrSpeedMbpsim ObjektdiversityZonesenthält und sich im US-Markt befindet.Um einen MCR an einem Standort bereitzustellen, muss die Portgeschwindigkeit im Objekt
diversityZonesverfügbar sein. Prüfen Sie, dass der Standort die verfügbare Geschwindigkeit und die Diversität-Zone für den MCR hat.
{
"id": 60,
"name": "CoreSite LA1",
"address": {
"street": "624 South Grand Avenue",
"suburb": null,
"city": "Los Angeles",
"state": "CA",
"postcode": "90017",
"country": "USA"
},
"dataCentre": {
"id": 18,
"name": "CoreSite"
},
"metro": "Los Angeles",
"market": "US",
"status": "Active",
"longitude": -118.25554,
"latitude": 34.04791,
"orderingMessage": null,
"diversityZones": {
"red": {
"mcrSpeedMbps": [
2500,
5000,
10000,
1000
],
"megaportSpeedMbps": [
1000,
10000,
100000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
},
"blue": {
"mcrSpeedMbps": [
5000,
1000,
2500,
10000
],
"megaportSpeedMbps": [
1000,
100000,
10000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
}
},
"productAddOns": {
"crossConnect": {
"available": true,
"type": "STANDARD"
}
}
}
Um einen MCR zu erstellen, benötigen Sie den id-Wert. In diesem Beispiel ist die Standort-ID 60.
So testen und validieren Sie die MCR-Bestellung
-
In Postman erweitern Sie Megaport Cloud Router (MCR) in der linken Navigation und wählen POST MCR-Bestellung validieren (v3) aus.
-
Aktualisieren Sie den Body mit der
locationId(60),productName(beliebiger Name für Ihren MCR),term(die Mindestanzahl von Monaten im verbindlichen Zeitraum: 1, 12, 24 oder 36) undportSpeed(1000, 2500, 5000 oder 10000 Mbps) und klicken Sie auf Send.
Ein ASN-Wert ist nur erforderlich, wenn Sie nicht das Standard-ASN von Megaport mit dem Wert 133937 verwenden möchten.
Fügen Sie eine Diversität-Zone hinzu. Überprüfen Sie die Standorteergebnisse, um festzustellen, welche Diversität-Zonen für Ihren MCR-Standort unterdiversityZonesverfügbar sind.
Wenn die Diversität-Zone nicht ausdrücklich ausgewählt ist, wird beim Erstellen des MCR automatisch eine zugewiesen.POST {baseUrl}/v3/networkdesign/validate
[
{
"locationId":60,
"term": 12,
"promoCode": "promox3mnthfree2",
"productName":"Test MCR",
"productType":"MCR2",
"portSpeed":2500,
"config": {
"mcrAsn": 133937,
"diversityZone":"blue"
}
}
]
Eine erfolgreiche Antwort besteht die Validierung und hat den HTTP-Status 200 OK. Die Antwort enthält außerdem Preisinformationen für den Dienst.
{
"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": 1440.00,
"fixedRecurringCharge": 0,
"postPaidBaseRate": "no base rate",
"longHaulMbpsRate": 0,
"mbpsRate": 6.000000000000000,
"currency": "USD",
"key": "no key",
"productType": "MCR2",
"empty": false
},
"serviceName": "API Test MCR",
"productType": "MCR2",
"productUid": "78aebd6b-7601-4331-82bc-dcd07f9f21a6",
"string": "Los Angeles"
}
]
}
Um die validierte MCR zu bestellen
-
Mit einer validierten MCR-Anfrage und überprüften Preisinformationen kopieren Sie den Body von POST Validate MCR Order (v3) und fügen ihn in den Body von POST Buy MCR (v3) ein.
Wichtig
Wenn Sie diesen Aufruf auf api.megaport.com durchführen, wird Ihr Konto mit der Dienstleistung belastet. Alternativ können Sie die API in der Staging-Umgebung (Testumgebung) ohne Gebühren verwenden, wie in diesen Beispielen.
-
Senden Sie die Anfrage.
Die folgende Ausgabe zeigt eine erfolgreiche Antwort.
{
"message": "MCR2 [426fa830-4b66-41ad-95a1-197d55e074b1] created.",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"serviceName": "Test MCR",
"name": "Test MCR",
"secondaryName": null,
"technicalServiceId": 187964,
"technicalServiceUid": "426fa830-4b66-41ad-95a1-197d55e074b1",
"requestedDate": 1707800936928,
"configuredDate": null,
"currentEstimatedDelivery": null,
"companyName": "Megaport Lab",
"companyId": 1153,
"billingContactName": null,
"billingContactId": null,
"adminContactName": null,
"adminContactId": null,
"technicalContactName": null,
"technicalContactId": null,
"salesName": null,
"salesId": null,
"billableId": 179527,
"billableUsageAlgorithm": null,
"productType": "MCR2",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": null,
"intercapPath": null,
"marketplaceVisibility": false,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1707800936928,
"terminationDate": null,
"contractStartDate": null,
"contractTermMonths": 12,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 2500,
"errorMessage": null,
"lagId": null,
"aggregationId": null,
"lagPrimary": null,
"market": "USA",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": "lax-cs1",
"bLocation": null,
"aMetro": "Los Angeles",
"aCountry": "USA",
"aLocationId": 60,
"bLocationId": null,
"bMetro": null,
"bCountry": null,
"attributeTags": {},
"createdBy": "f39b8983-256e-4643-adec-9f0b5da09ab7",
"buyoutPort": false,
"virtual": true,
"locked": false,
"adminLocked": false,
"bgpShutdownDefault": false,
"originDomain": null
}
]
}
Der neue MCR erscheint nun in Ihrer Arbeitsumgebung, entweder portal.megaport.com oder portal-staging.megaport.com.
Tipp
Um alle Optionen für die in diesem Beispiel verwendeten Anfragen zu sehen, siehe https://dev.megaport.com.
Der nächste Schritt besteht darin, VXCs zu diesem MCR zu erstellen.
Weitere Informationen finden Sie unter: