Creazione di un VXC tra un MCR e Microsoft Azure tramite API
Questo argomento descrive la procedura API per creare un VXC da un MCR a Microsoft Azure ExpressRoute, compreso come cercare le posizioni di interconnessione di Azure e ordinare i VXC.
Il dispiegamento di MCR ad Azure include queste attività:
-
Configura un circuito ExpressRoute nella console di Azure
Quando viene implementato, si ottiene una chiave di servizio. Quando si convalida una chiave di servizio, vengono presentate porte primarie e secondarie e puoi scegliere la porta per la connessione. Puoi utilizzare la chiave una seconda volta e creare un’altra connessione alla porta inutilizzata.
Per ulteriori informazioni, consulta l’argomento di aiuto di Microsoft Tutorial: Crea e modifica un circuito ExpressRoute.
-
Con la chiave di servizio, crea e implementa il tuo VXC
Come parte della configurazione VXC, puoi scegliere il tipo di peering.
Il tipo di peering può essere privato o Microsoft.
Un tipo di peering definito comporta la configurazione automatica del peering con pari corrispondenti su entrambi i lati di Azure e Megaport, e un sistema implementato con una configurazione di lavoro nota. Puoi modificare la configurazione una volta implementata.
Prima di iniziare, ottieni un token di accesso valido. Per ulteriori informazioni, vedi Creazione di una chiave API.
Convalida della chiave di servizio
Quando utilizzi l’API per convalidare una chiave di servizio Azure, la risposta include i dettagli di ExpressRoute delle porte e dei peers 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 > MCR > Azure nella navigazione a sinistra e seleziona GET Look Up Azure Service Key.
-
Aggiungi la chiave di servizio al punto di fine.
-
Fai clic 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": "Ricerca riuscita",
"terms": "Questi dati sono soggetti alla Politica di utilizzo accettabile 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 a 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 a 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": []
}
}
Per ulteriori informazioni su ogni campo della risposta, vedere Campi di risposta dell’API della chiave del servizio Azure.
Ordinare un VXC con opzioni di peering
Con i dettagli dalla chiave di servizio, creare un VXC per la porta primaria e un altro VXC per la porta secondaria. Assicurarsi di selezionare un MCR nella stessa regione delle porte Azure dalla richiesta di ricerca della chiave di servizio.
Se si specifica il tipo di peering nella richiesta API per il VXC, Megaport configurerà l’indirizzamento IP e i dettagli BGP sia sul lato MCR che sul lato Azure per garantire una configurazione BGP funzionante.
Per specificare il tipo di peering, aggiungere un tipo di peering all’array peers nella sezione partnerConfig. Se non esiste un array peers, i peers vengono recuperati da Azure. Se i peers non sono specificati durante la creazione del VXC e non ci sono peers in Azure (che è normalmente il caso per le nuove chiavi di servizio), il peering MCR non verrà autoconfigurato.
Il MCR crea una VLAN per ogni tipo di peering configurato. Se sono specificate entrambe le opzioni di peering private e Microsoft, il MCR configura due VLAN interne.
Nota
I tipi di peering vengono memorizzati e non possono essere modificati se una chiave è stata utilizzata in precedenza.
Per creare il VXC
-
Creare una richiesta con l’endpoint POST Create VXC to Azure (v3):
POST {baseUrl}/v3/networkdesign/buySuggerimento
Per testare la richiesta prima di ordinare, è possibile utilizzare: POST {baseUrl}/v3/networkdesign/validate
-
Aggiornare il Body della richiesta con il
productUiddel MCR, il nome del VXC, ilproductUiddella porta Azure e la chiave di servizio. Includere l’opzione di peering appropriata. La velocità massima (rateLimit) è definita nel valore di larghezza di banda della risposta della chiave di servizio. In questo caso, è 200.La VLAN Azure (se specificata) è la VLAN outer tag per Q-in-Q. Se non si specifica la VLAN, sarà autoprovisionata.
Per utilizzare una chiave Azure con l’opzione di peering privato, utilizzare questo modello:
[
{
"productUid": "{{mcrid}}",
"associatedVxcs": [
{
"productName": "Azure Primary VXC",
"rateLimit": 200,
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 0
},
"bEnd": {
"productUid": "{{azurepuid}}",
"vlan": "{{azurevlan}}",
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "{{azurekey}}",
"peers": [{"type": "private"}]
}
}
}
]
}
]
Per il peering Microsoft, utilizzare questa riga per i peers:
Per il peering sia Microsoft che privato, utilizzare questa riga:
Dopo aver creato un VXC per la porta primaria di Azure, crea un altro VXC per connetterti al productUid della porta secondaria di Azure (modifica il productName e il bEnd: productUid).
Risposta configurata
Quando crei i VXC con peering, un’altra richiesta di validazione della chiavi di servizio mostra la configurazione completa.
{
"message": "Ricerca riuscita",
"terms": "Questi dati sono soggetti alla Politica di utilizzo accettabile https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": true,
"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 a Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60574,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute a Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60575,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": [
{
"peer_asn": 133937,
"shared_key": null,
"primary_subnet": "169.254.167.176/30",
"secondary_subnet": "169.254.167.180/30",
"vlan": 100,
"type": "private"
},
{
"peer_asn": 133937,
"shared_key": null,
"prefixes": "117.18.81.116/30,117.18.81.120/30",
"primary_subnet": "117.18.81.116/30",
"secondary_subnet": "117.18.81.120/30",
"vlan": 200,
"type": "microsoft"
}
]
}
}