Creazione di un VXC tra una Port e Microsoft Azure tramite API
Questo argomento descrive la procedura API per creare un VXC da una Port a Microsoft Azure ExpressRoute, inclusa la ricerca delle posizioni delle porte Azure e l’ordine dei VXC.
Il dispiegamento della Port ad Azure comprende queste attività:
-
Configura un circuito ExpressRoute nella console Azure
Una volta dispiegato, si ottiene una chiave di servizio. La chiave di servizio è collegata alle porte assegnate in Azure. Quando si convalida una chiave di servizio, la risposta mostra le porte primaria e secondaria assegnate in Azure. È possibile utilizzare la chiave di servizio due volte: una volta per connettersi al primario e una seconda volta per creare un’altra connessione alla porta secondaria. Per maggiori informazioni, consulta l’argomento di aiuto di Microsoft Tutorial: Crea e modifica un circuito ExpressRoute.
-
Con la chiave di servizio, crea e distribuisci i tuoi VXC dal Megaport Portal
Questo passaggio utilizza l’API: gli altri passaggi sono al di fuori di Megaport nell’ambiente Azure.
-
Con un VXC distribuito al tuo circuito, configura il peering nel portale Azure
Le informazioni di peering sono condivise tra i circuiti primario e secondario, così come la VLAN interna assegnata al peer. Per maggiori informazioni, consulta l’argomento di aiuto di Microsoft Crea e modifica il peering per un circuito ExpressRoute.
-
Configura l’attrezzatura del cliente in loco (CPE)
Prima di iniziare, ottieni un token di accesso valido. Per maggiori informazioni, vedi Creazione di una chiave API.
Convalida della chiave di servizio
Quando si utilizza l’API per convalidare una chiave di servizio Azure, la risposta include i dettagli di ExpressRoute delle porte e dei peer associati. Hai bisogno dei dettagli della porta per creare i VXC.
Per convalidare la chiave di servizio nella raccolta Postman
-
In Postman, espandi Cloud Connectivity > Port > Azure nella navigazione a sinistra e seleziona GET Look Up Azure Service Key.
-
Aggiungi la chiave di servizio all’endpoint.
-
Clicca su Invia per inviare una richiesta GET al server API.
GET {baseUrl}/v2/secure/azure/{service_key}
Ecco un esempio di risposta per una nuova chiave (senza VXC configurati):
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
Il valore megaports:vxc è null per entrambe le porte, il che indica che sono disponibili per nuovi VXC.
Per ulteriori informazioni su ciascun campo della risposta, vedi Campi di risposta dell’API della chiave del servizio Azure.
Crea e distribuisci i VXC
Con i dettagli della chiavi di servizio, crea un VXC verso la porta primaria e un altro VXC verso la porta secondaria.
Per creare i VXC
-
Seleziona POST Create VXC to Azure (v3).
Suggerimento
Per testare la tua richiesta prima di ordinarla e visualizzare i dettagli dei prezzi, puoi usare:
POST {baseUrl}/v3/networkdesign/validate -
Aggiorna il corpo della richiesta con il
productUiddella porta, il nome del VXC, ilproductUiddella porta primaria di Azure e la chiavi di servizio. La velocità massima (rateLimit) è definita nel valore di banda della risposta della chiavi di servizio. In questo caso, è 200. -
Fai clic su Invia per inviare la richiesta.
POST {baseUrl}/v3/networkdesign/buy
[
{
"productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID della tua Megaport (A-End)
"associatedVxcs": [
{
"productName": "Primary Azure VXC",
"rateLimit": 200,
"term":12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 102
},
"bEnd": {
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008", //port UID ricevuto dalla ricerca della chiave di servizio Azure
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "3e2480b2-b4d5-424b-976a-7b0de65a1b62" //chiave di servizio dalla risposta alla ricerca
}
}
}
]
}
]
Quando hai configurato i tuoi VXC primario e secondario verso le porte Azure, una nuova ricerca della chiavi di servizio mostra i VXC associati alle porte Azure. I VXC sono identificati da un numero ID (megaports:vxc).
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60621,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60622,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
Per completare la configurazione, configura il peering nel portale Azure e configura i tuoi dispositivi CPE.