Creazione di un MCR con l’API
Questo argomento descrive la procedura API per creare un MCR, compreso come cercare le posizioni del MCR, e come convalidare e completare l’ordine.
Prima di iniziare, ottenere un token di accesso valido. Per ulteriori informazioni, consultare Creazione di una chiave API.
Per cercare i dettagli sulla posizione del MCR nella collezione Postman
-
Espandi la cartella Locations nella navigazione a sinistra e fai clic su GET Locations (v3).
Questa richiesta non prevede Parametri o informazioni del Body. -
Clicca su Invia per fare una richiesta GET.
GET {baseUrl}/v3/locations
Assicurati che la richiesta sia stata eseguita con successo cercando lo Stato: 200 OK e visualizzando la risposta nella sezione Body in formato Pretty.
La richiesta restituisce centinaia di posizioni Megaport.
-
Fai clic sulla lente d’ingrandimento e cerca nella risposta un sito che include
mcrSpeedMbpsnell’oggettodiversityZonese che si trovi nel mercato USA.Per mettere a disposizione un MCR in una posizione, la velocità della porta deve essere disponibile nell’oggetto
diversityZones. Verifica che la posizione abbia la velocità disponibile e la zona di diversità per l’MCR.
{
"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"
}
}
}
Per creare un MCR, è necessario il valore id. In questo esempio, l’ID della location è 60.
Per testare e convalidare l’ordine del MCR
-
In Postman, espandi Megaport Cloud Router (MCR) nella navigazione a sinistra e seleziona Validate MCR Order (v3).
-
Aggiorna il Body con
locationId(60),productName(qualsiasi nome desideri per il tuo MCR),term(il numero minimo di mesi del termine contrattuale: 1, 12, 24 o 36) eportSpeed(1000, 2500, 5000 o 10000 Mbps), quindi fai clic su Invia.
Un valore ASN è richiesto solo se non vuoi usare l’ASN predefinito di Megaport, pari a 133937.
Aggiungi una diversity zone. Controlla i risultati della location per vedere quali diversity zone sono disponibili per la location del tuo MCR sottodiversityZones.
Se non viene selezionata esplicitamente una diversity zone, una verrà assegnata automaticamente al momento della creazione del MCR.POST {baseUrl}/v3/networkdesign/validate
[
{
"locationId":60,
"term": 12,
"promoCode": "promox3mnthfree2",
"productName":"Test MCR",
"productType":"MCR2",
"portSpeed":2500,
"config": {
"mcrAsn": 133937,
"diversityZone":"blue"
}
}
]
Una risposta di successo supera la convalida e ha uno stato 200 OK. La risposta include anche i dettagli dei prezzi del servizio.
{
"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"
}
]
}
Per ordinare il MCR convalidato
-
Con una richiesta MCR convalidata e le informazioni sui costi revisionate, copia il Body da POST Validate MCR Order (v3) e incollalo nel Body di POST Buy MCR (v3).
Importante
Se effettui questa chiamata su api.megaport.com, il tuo account verrà addebitato per il servizio. In alternativa, puoi utilizzare l’API nell’ambiente di staging (test) senza costi, come in questi esempi.
-
Invia la richiesta.
Questo output mostra una risposta di successo.
{
"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
}
]
}
Il nuovo MCR appare ora nel tuo ambiente di lavoro, che sia portal.megaport.com o portal-staging.megaport.com.
Suggerimento
Per vedere tutte le opzioni per le richieste utilizzate in questo esempio, consulta https://dev.megaport.com.
Il passo successivo è creare VXC per questo MCR.
Per ulteriori informazioni, consultare: