Creazione di una VXC tra un MVE e Microsoft Azure con l’API
Questo argomento descrive la procedura API per creare una VXC da un MVE a Microsoft Azure ExpressRoute. La configurazione è un processo in due passaggi: prima si cercano le posizioni di interconnessione Azure con la chiave del servizio Azure, poi si può creare la VXC su una specifica vNIC del proprio MVE.
Nota
Prima di poter connettersi ad Azure, è necessario impostare un circuito ExpressRoute nella console Azure. Una volta impostato, si riceve una chiave di servizio con i dettagli della connessione. Per configurare la connessione del proprio MVE ad Azure, si cercano i dettagli della chiave di servizio e poi si creano delle VXC verso le porte Azure.
Il dispiegamento dello MVE su Azure include queste operazioni:
-
Impostare un circuito ExpressRoute nella console Azure
Una volta dispiegato, si ottiene una chiave di servizio. Quanto si valida una chiave di servizio, vengono presentate le porte primarie e secondarie e si può scegliere la porta per la connessione. Si può utilizzare la chiave una seconda volta e creare un’altra connessione alla porta non utilizzata.
Per maggiori informazioni, consultare l’argomento di aiuto Microsoft Tutorial: Crea e modifica un circuito ExpressRoute.
-
Convalidare la chiave del servizio Azure
Durante l’ordine di un servizio Azure, utilizzare la chiave del servizio e assicurarsi che ci sia una porta libera per una connessione.
La risposta API include i dettagli dell’ExpressRoute delle porte e dei peer associati. Abbiamo bisogno dei dettagli della porta Azure per creare la VXC.
-
Creare e implementare una VXC
Con la chiave di servizio convalidata e i dettagli della porta, crea la VXC verso Microsoft Azure dal MVE.
Come parte della configurazione della VXC, è possibile scegliere il tipo di peering. Il tipo di peering può essere privato o Microsoft.
Un tipo di peering definito genera un peering configurato automaticamente con peer corrispondenti su entrambi i lati Azure e Megaport e un sistema implementato con una configurazione funzionante nota. È possibile modificare la configurazione una volta implementata.
Prima di iniziare, ottenere un token di accesso valido. Per maggiori informazioni, vedere Creazione di una chiave API.
Convalidare la chiave del servizio
Utilizzare l’API per convalidare una chiave del servizio Microsoft Azure. La risposta include i dettagli dell’ExpressRoute delle porte e dei peer associati. È necessario avere i dettagli della porta Azure per creare la VXC.
Esaminare la chiave di servizio e assicurarsi che vi sia una Porta libera per una connessione. Nella risposta dell’API, le porte disponibili sono elencate come "vxc":null e le porte con un valore assegnato non sono disponibili.
Per maggiori informazioni su ciascun campo di risposta, vedere Campi di risposta della chiave del servizio Azure.
Per convalidare la chiave del servizio
-
Utilizzare l’API GET Look Up Azure Service Key per cercare i dettagli della posizione di Microsoft Azure con la chiave del servizio:
GET {baseUrl}/v2/secure/azure/{service_key}
Ecco un esempio di risposta per una chiave di accoppiamento con una porta disponibile (vxc = null).
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"bandwidth": 50,
"connectType": "AZURE",
"managed": false,
"megaports": [
{
"productId": 53013,
"productUid": "83f95deb-a537-485e-80d9-c442c776ddc9",
"name": "London Primary",
"nServiceId": 119129,
"description": "Azure ExpressRoute at Equinix LD5",
"companyId": 1475,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"companyName": "Azure ExpressRoute",
"portSpeed": 10000,
"locationId": 90,
"state": null,
"country": "United Kingdom",
"port": 53013,
"type": "primary",
"vxc": null
},
{
"productId": 53014,
"productUid": "d84ad163-8e22-4150-8cb7-44f1aecf9e90",
"name": "London Secondary",
"nServiceId": 119130,
"description": "Azure ExpressRoute at Equinix LD5",
"companyId": 1475,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"companyName": "Azure ExpressRoute",
"portSpeed": 10000,
"locationId": 90,
"state": null,
"country": "United Kingdom",
"port": 53014,
"type": "secondary",
"vxc": null
}
],
"peers": [],
"resource_type": "csp_connection",
"service_key": "3f0f66b9-0c82-4d61-ae31-f5985c841a4a",
"vlan": 19
}
}
Creare e distribuire un VXC su una vNIC specifica
Con i dettagli della porta Azure ExpressRoute ottenuti dalla ricerca della chiave del servizio, crea il VXC verso Azure.
Specifica i dettagli di configurazione nel corpo della richiesta. Il primo productUid identifica il MVE e il campo bEnd: productUid identifica l’interfaccia Azure. È inoltre necessario fornire la chiave del servizio Azure ExpressRoute nel campo serviceKey.
Suggerimento
Consulta le posizioni Azure per l’estremità B della connessione utilizzando l’endpoint v2/dropdowns/partner/megaports.
È possibile creare più connessioni su un’interfaccia Azure, ad esempio se è necessario connettere sia il peer privato sia quello Microsoft alla stessa interfaccia.
VLAN di peering Azure singola
In questo esempio viene utilizzata una VLAN di peering Azure singola. È possibile capirlo perché vengono specificati sia l’aEnd innerVlan sia il bEnd innerVlan. Per una VLAN di peering Azure singola entrambi sono impostati sullo stesso valore.
Se questo valore è impostato su 0, il sistema assegnerà e imposterà automaticamente una VLAN interna valida.
Suggerimento
Per testare la richiesta prima di inviarla e visualizzare i dettagli dei prezzi, utilizza l’endpoint /v3/networkdesign/validate con la stessa configurazione del corpo.
Per creare un VXC
-
Crea una richiesta con l’endpoint POST Create VXC to Azure (v3):
POST {baseUrl}/v3/networkdesign/buy -
Aggiorna il corpo della richiesta con il
productUiddel MVE, il nome del VXC, ilproductUiddella porta Azure e imposta la chiave del servizio coninnerVlansu 501 evNicIndexsu 0 (interfaccia 1).Nota
Il numero vNIC si riferisce alle seguenti interfacce MVE:
- vNIC 0 = interfaccia 1 sul MVE
- vNIC 1 = interfaccia 2 sul MVE
- vNIC 2 = interfaccia 3 sul MVE
- vNIC 3 = interfaccia 4 sul MVE
- vNIC 4 = interfaccia 5 sul MVE
[
{
"productUid": "{{ mveid }}",
"associatedVxcs": [
{
"productName": "Link to Azure ",
"partnerConfigs" : {
"connectType": "AZURE",
"serviceKey": "((azureServiceKey}}"
},
"rateLimit": 1000,
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vNicIndex":0,
"innerVlan": 501
},
"bEnd": {
"productUid": "{{ azurePortUid }}",
"innerVlan": 501
}
}
]
}
]
Dopo aver inviato la richiesta, riceverai una risposta positiva quando il VXC sarà stato ordinato.
Ecco un esempio di risposta:
{
"message": "VXC [7f7c22f6-5cde-45d7-8603-f3546c714118] created.",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1709822378799,
"vxcOrderId": 139947,
"payerMegaPortId": 190079,
"nonPayerMegaPortId": 53013,
"payerMegaPortName": "MVE for VNIC config",
"nonPayerMegaPortName": "London Primary",
"payerCompanyId": 1153,
"nonPayerCompanyId": 1475,
"payerLocationId": 89,
"nonPayerLocationId": 90,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "Azure ExpressRoute",
"payerMegaPortNsId": 510708,
"nonPayerMegaPortNsId": 119129,
"payerVlanId": 0,
"nonPayerVlanId": 0,
"payerInnerVlanId": 501,
"nonPayerInnerVlanId": 501,
"payerApproverName": "name",
"payerApproverId": 41315,
"nonPayerApproverName": "name",
"nonPayerApproverId": number,
"payerApproval": number,
"nonPayerApproval": number,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from MVE for VNIC config to London Primary",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 1000,
"distanceBand": "METRO",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"dealUid": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 190104,
"vxcJTechnicalServiceUid": "7f7c22f6-5cde-45d7-8603-f3546c714118",
"provisionDate": 1709822378782,
"orderType": "NEW",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": null,
"amsixConnectConfigDto": null,
"sdrcProvItem": null,
"rate": null,
"setup": null,
"asn": null,
"bgpPassword": null,
"usageAlgorithm": "POST_PAID_HOURLY_SPEED_METRO_VXC",
"costCentre": null,
"azureServiceKey": "{{ azureServiceKey }}",
"oracleVirtualCircuitId": null,
"serviceKey": null,
"vxc": {
"serviceName": "Link to Azure ",
"name": "Link to Azure ",
"secondaryName": null,
"technicalServiceId": 190104,
"technicalServiceUid": "7f7c22f6-5cde-45d7-8603-f3546c714118",
"requestedDate": 1709822378782,
"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": 181652,
"billableUsageAlgorithm": null,
"productType": "VXC",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": "METRO",
"intercapPath": "",
"marketplaceVisibility": true,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1709822378792,
"terminationDate": null,
"contractStartDate": null,
"contractTermMonths": 1,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 1000,
"errorMessage": null,
"lagId": null,
"aggregationId": null,
"lagPrimary": null,
"market": "UK",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": null,
"bLocation": null,
"aMetro": null,
"aCountry": null,
"aLocationId": null,
"bLocationId": null,
"bMetro": null,
"bCountry": null,
"attributeTags": {},
"createdBy": "b0dedbd2-ecc7-4bad-a13b-6c34b4005115",
"buyoutPort": null,
"virtual": false,
"locked": false,
"adminLocked": false,
"bgpShutdownDefault": false,
"originDomain": null
},
"connectType": "AZURE",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"serviceLicense": null,
"originDomain": null,
"fullyApproved": true
}
]
}
Peer Microsoft multipli (Q-in-Q)
Se non vuoi usare Single Azure Peering VLAN e desideri utilizzare Q-in-Q per avere più peer Microsoft su un singolo VXC, specifica solo il valore di aEnd innerVlan.
Con Q-in-Q in uso, l’ID VLAN di peering di Azure impostato in Azure non è visibile nelle API di Megaport o nel Portal. È configurato dal cliente nei peer ExpressRoute di Azure e abbinato alla configurazione dell’istanza MVE.
Nell’esempio qui sotto, il campo aEnd innerVlan con valore 100 è in realtà una VLAN esterna o s-tag sul MVE. La VLAN interna Q-in-Q (c-tag) che gira all’interno dell’innerVlan è trasparente per Megaport.
Nota
I VXC Azure sono l’unico tipo di VXC cloud che ti permette di specificare un VXC a doppio tag.
Ecco un esempio di richiesta:
[
{
"productUid": "02ec2091-46bb-4904-bd17-96c752ff826e",
"associatedVxcs": [
{
"productName": "My New Azure VXC",
"partnerConfigs" : {
"connectType": "AZURE",
"serviceKey": "{{ service_key }}"
},
"rateLimit": 1000,
"term": 12,
"shutdown": false,
"aEnd": {
"innerVlan": 100
},
"bEnd": {
"productUid": "{{ azurepuid }}"
}
}
]
}
]