Creazione di un Port con l’API
Questo argomento descrive la procedura API per creare un Port, incluso come cercare le località dei Port, validare il Port e determinare il costo, ordinare il Port e scaricare la Lettera di autorizzazione (LOA)Una Lettera di Autorizzazione (LOA) è un documento che i clienti devono presentare al loro fornitore di data center per stabilire il cross-connect fisico dai loro servizi di data center al loro Port. La LOA è fornita tramite il Megaport Portal quando un cliente provvede a una nuova Port.
.
Prima di iniziare, ottieni un token di accesso valido. Per ulteriori informazioni, consulta Creazione di una chiave API.
Per cercare i dettagli della località del Port nella raccolta Postman
-
Fai clic su Località nella navigazione a sinistra e fai clic su OTTIENI Località (v3).
Questa richiesta non prevede informazioni sui parametri o sul corpo. -
Fai clic su Invia per effettuare la richiesta.
GET {baseUrl}/v3/locationsAssicurati che la richiesta sia stata eseguita correttamente cercando lo Status: 200 OK e visualizzando la risposta nella sezione Corpo nel formato Pretty.
La richiesta restituisce centinaia di località dei Port. Puoi cercare cliccando sulla lente d’ingrandimento e inserendo una città specifica, un data center o un altro parametro nel campo di ricerca. Questo esempio utilizza la località di Digital Realty, Londra.
{
"id": 89,
"name": "Digital Realty London LHR20",
"address": {
"street": "227 Marsh Wall",
"suburb": null,
"city": "London",
"state": null,
"postcode": "E14 9SD",
"country": "United Kingdom"
},
"dataCentre": {
"id": 3,
"name": "Digital Realty"
},
"metro": "London",
"market": "UK",
"status": "Active",
"longitude": -0.012144,
"latitude": 51.499714,
"orderingMessage": null,
"diversityZones": {
"red": {
"mcrSpeedMbps": [
5000,
100000,
1000,
25000,
10000,
2500,
50000
],
"megaportSpeedMbps": [
100000,
10000,
1000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
},
"blue": {
"mcrSpeedMbps": [
1000,
2500,
5000,
10000
],
"megaportSpeedMbps": [
1000,
10000,
100000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
}
},
"productAddOns": {
"crossConnect": {
"available": false,
"type": null
}
}
}
Per creare un Port, ti servono i valori market e id. In questo esempio, il market è UK e l’ID del data center è 89.
Per testare e convalidare l’ordine del Port
-
In Postman, apri la cartella Port nella navigazione a sinistra e seleziona POST Validate Port Order (v3).
-
Aggiorna il Body con il
locationId(89), ilterm(numero di mesi - 1, 12, 24 o 36), ilproductName(il nome che vuoi per il tuo Port), ilportSpeed(1000, 10000 o 100000 Mbps) e ilmarket(UK) e clicca su Invia.
[
{
"locationId": 89,
"term": 1,
"locationUid": null,
"productName": "Port API",
"productType": "MEGAPORT",
"createDate": 1452475039656,
"portSpeed": 1000,
"virtual": false,
"promoCode": "promox3mnthfree2",
"market": "UK"
}
]
Una risposta di successo supera la convalida e ha uno status 200 OK. La risposta include anche i dettagli dei prezzi del servizio.
{
"message": "La validazione è passata",
"terms": "Questi dati sono soggetti alla politica di utilizzo accettabile https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"price": {
"hourlySetup": 0,
"dailySetup": 0,
"monthlySetup": 0,
"hourlyRate": 0,
"dailyRate": 0,
"monthlyRate": 500.00,
"fixedRecurringCharge": 500.00,
"postPaidBaseRate": "nessuna tariffa base",
"longHaulMbpsRate": 0,
"mbpsRate": 0,
"currency": "GBP",
"key": "nessuna chiave",
"productType": "MEGAPORT",
"empty": false
},
"serviceName": "Port API",
"productType": "MEGAPORT",
"productUid": "f9859fd3-344d-4a33-8cd2-a3b6ebfaaef0",
"market": "UK",
"string": "London"
}
]
}
Per ordinare il Port validato
-
Con una richiesta di Port validata e informazioni sul costo esaminate, copia il Corpo da POST Validazione ordine Port (v3) e incolla nel Corpo di POST Acquista Port (v3).
Importante
Se effettui questa chiamata su api.megaport.com, il tuo account sarà addebitato per il servizio. In alternativa, puoi provvedere contro l’API di staging senza addebiti, come in questi esempi.
-
Invia la richiesta.
Una risposta positiva include untechnicalServiceUid, che è lo stesso delproductUid.
Per il nostro esempio, questo valore è a49cf3f1-20a1-4390-93aa-5005bdafe3d7.
{
"message": "MEGAPORT [a49cf3f1-20a1-4390-93aa-5005bdafe3d7] creato. ",
"terms": "Questi dati sono soggetti alla politica di utilizzo accettabile https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"serviceName": "Port API",
"name": "Port API",
"secondaryName": null,
"technicalServiceId": 68124,
"technicalServiceUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"requestedDate": 1588862976322,
"configuredDate": null,
"currentEstimatedDelivery": null,
"companyName": "Laboratorio Megaport",
"companyId": 2278,
"aggregationId": null,
"lagPrimary": false,
"billingContactName": null,
"billingContactId": null,
"adminContactName": null,
"adminContactId": null,
"technicalContactName": null,
"technicalContactId": null,
"salesName": null,
"salesId": null,
"billableId": 56333,
"billableUsageAlgorithm": "NOT_POST_PAID",
"productType": "MEGAPORT",
"provisioningStatus": "CLEARED_FOR_DEPLOYMENT",
"inAdvanceBillingStatus": "NOT_ACTIVATED",
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": null,
"intercapPath": null,
"marketplaceVisibility": true,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1588862976322,
"terminationDate": null,
"contractStartDate": 1588860000000,
"contractTermMonths": 1,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 10000,
"errorMessage": null,
"market": "UK",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": null,
"bLocation": null,
"aLocationId": null,
"bLocationId": null,
"attributeTags": {},
"createdBy": "a51cc1c6-95a0-48c7-a5a0-e49d77a6c536",
"buyoutPort": false,
"virtual": false,
"locked": false,
"adminLocked": false
}
]
}
Il nuovo Port appare ora nel tuo ambiente di lavoro, sia portal.megaport.com che portal-staging.megaport.com.
Suggerimento
Per vedere tutte le opzioni per le richieste utilizzate in questo esempio, consulta https://dev.megaport.com.
Scarica la Lettera di autorizzazione (LOA)
Dopo aver creato il tuo Port, puoi scaricare la LOA.
Nota
Prima di poter scaricare la LOA, lo stato della provvista del Port deve essere Configurato.
Per scaricare la LOA
-
In Postman, espandi Port nella navigazione a sinistra e seleziona GET Rigenera LOA per servizio Megaport.
-
Nel comando GET, sostituisci il
productIDcon il valore creato durante la creazione del Port. -
Invia la richiesta.
Con una risposta positiva 200 OK, questo messaggio appare nella sezione Corpo:
Questa risposta non può essere visualizzata in anteprima. Scarica la risposta per aprirla con un'applicazione appropriata.Questo messaggio appare perché la LOA è un documento PDF e deve essere scaricato. Per scaricare, fai clic su Salva Risposta in Postman e salva il PDF in una posizione conveniente.