Creazione di un VXC per AWS con l’API
Questo argomento descrive la procedura API per creare un VXC da una Porta a AWS, incluso come cercare le località di interconnessione cloud, convalidare la connessione e ordinare il VXC.
L’esempio in questo argomento crea una connessione Hosted VIF ad AWS con un tasso di trasferimento dati di 500 Mbps. Per seguire questo esempio, utilizza l’URL dell’ambiente di staging, che ti permette di configurare le connessioni ma non distribuisce o addebita i servizi.
Prima di iniziare, ottieni un token di accesso valido. Per ulteriori informazioni, vedi Creazione di una chiave API.
Suggerimento
Per vedere tutte le opzioni per le richieste utilizzate in questo esempio, vedi https://dev.megaport.com.
Ricerca dei dettagli della posizione del porto AWS
Per creare un VXC per AWS, devi conoscere i dettagli del porto AWS. Usa l’API per restituire le interfacce che Megaport ha con i fornitori di servizi cloud, per identificare i dettagli del porto AWS necessari.
Per cercare i dettagli della posizione del porto AWS nella raccolta Postman
-
Espandi la cartella Locations nella navigazione a sinistra e fai clic su GET Partner Megaports.
-
Fai clic su Invia per inviare una richiesta GET al server API.
GET {baseUrl}/v2/dropdowns/partner/megaports
Questa richiesta restituisce tutte le interfacce che Megaport ha con i fornitori di servizi cloud. Puoi cercare facendo clic sulla lente di ingrandimento e inserendo una località, un data center o un altro parametro nel campo di ricerca.
Il connectType indica il fornitore di servizi cloud. AWS include “AWS” per Hosted VIFs e “AWSHC” per le connessioni ospitate.
Puoi filtrare i risultati per
connectType
evxcPermitted
.GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=true
Questo esempio utilizza un porto in Interxion DUB2 che sta accettando VXC (
“vxcPermitted”: true
) ed è nella regione eu-west-1.
{
"connectType": "AWS",
"productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
"vxcPermitted": true,
"companyUid": "623cb950-abb4-4b07-b372-8cf55756c322",
"companyName": "AWS",
"title": "EU (Irlanda) (eu-west-1)",
"locationId": 96,
"speed": 10000,
"rank": 61,
"lag_id": 2,
"lag_primary": true,
"aggregation_id": 54188
},
Creare e distribuire un VXC
Con i dettagli della porta AWS ottenuti tramite l’API GET Partner Megaports, puoi convalidare e quindi creare un VXC.
Per testare e convalidare l’ordine
-
In Postman, espandi Cloud Connectivity > Port > AWS Direct Connect nella navigazione a sinistra e seleziona POST Validate AWS - Hosted VIF (v3).
-
Aggiorna il Body della richiesta con il
productUid
della Porta, ilproductUid
della porta AWS e l’ID account AWS.
Puoi anche modificare altri valori, come nome, limite di velocità, durata del contratto, VLAN ID, valori ASN, authKey e indirizzamento IP. -
Clicca su Invia per inviare la richiesta POST.
POST {baseUrl}/v3/networkdesign/validate
[
{
"productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"associatedVxcs": [
{
"productName": "Il mio Direct Connect Amazon",
"rateLimit": "500",
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 777
},
"bEnd": {
"productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
"partnerConfig": {
"connectType": "AWS",
"name": "Nome Amazon per il servizio",
"type": "private",
"asn": 65105,
"amazonAsn": 64555,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123456",
"prefixes": "10.0.1.0/24",
"customerIpAddress": null,
"amazonIpAddress": null
}
}
}
]
}
]
Quando convalidato, sei pronto per effettuare l’ordine del VXC.
Per creare un VXC
-
Copia il Body convalidato da POST Validate AWS - Hosted VIF (v3) e incollalo nel Body di POST Buy AWS - Hosted VIF (v3).
-
Clicca su Invia per inviare la richiesta POST.
POST {baseUrl}/v3/networkdesign/buy
Ecco un esempio di risposta di successo.
{
"message": "VXC [47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e] creato. ",
"terms": "Questi dati sono soggetti alla Politica di utilizzo accettabile https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1588868593704,
"vxcOrderId": 42328,
"payerMegaPortId": 68124,
"nonPayerMegaPortId": 52786,
"payerMegaPortName": "Porta API",
"nonPayerMegaPortName": "EU (Irlanda) (eu-west-1)",
"payerCompanyId": 2278,
"nonPayerCompanyId": 117,
"payerLocationId": 89,
"nonPayerLocationId": 96,
"salesId": null,
"payerCompanyName": "Laboratorio Megaport",
"nonPayerCompanyName": "AWS",
"payerMegaPortNsId": 138231,
"nonPayerMegaPortNsId": 221182,
"payerVlanId": 777,
"nonPayerVlanId": 0,
"payerApproverName": "Paolo McGuinness",
"payerApproverId": 12695,
"nonPayerApproverName": "Paolo McGuinness",
"nonPayerApproverId": 12684,
"payerApproval": 1582268553574,
"nonPayerApproval": 1228868693614,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "da Porta API a EU (Irlanda) (eu-west-1)",
"payerStatus": "APPROVATO",
"nonPayerStatus": "APPROVATO",
"speed": 500,
"distanceBand": "ZONA",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"rateType": "MENSILE",
"vxcJTechnicalServiceId": 57115,
"vxcJTechnicalServiceUid": "47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e",
"provisionDate": 1588868593517,
"orderType": "NUOVO",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": {
"type": "private",
"asn": 65105,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123456",
"customerIpAddress": null,
"amazonIpAddress": null,
"prefixes": "10.0.1.0/24",
"name": "Nome Amazon per il servizio"
},
"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
}
]
}
La Porta e il VXC ora appaiono nel Megaport Portal.
Per questo esempio, l’Hosted VIF AWS apparirà nell’account del portale AWS sotto Direct Connect - Interfacce virtuali. Il titolare dell’account può accettare l’Interfaccia Virtuale e collegarla a un Gateway Privato Virtuale o a un Gateway Direct Connect e quindi ai loro VPC.