Gestione della connettività con le API di Megaport come fornitore di servizi
I fornitori di servizi possono integrare in modo fluido le funzionalità di Megaport nella loro piattaforma. Possono controllare l’accesso dei clienti alle loro rampe di accesso, come ad esempio i Port.
I fornitori di servizi possono utilizzare una chiave di servizio per gestire l’accesso dei clienti e la connettività sicura alle loro rampe di accesso. Possono impostare limiti di velocità specifici e segmentare il traffico dei clienti utilizzando VLAN.
Una chiave di servizio è un codice che viene fornito da un titolare di account Megaport a un altro per collegare due aziende separate. I clienti che hanno account Megaport separati possono collegare i loro Port, MCR, o MVE tra loro attraverso la rete Megaport, consentendo VXC da azienda a azienda.
Prima di consentire ai loro clienti di connettersi a una rampa di accesso utilizzando una chiave di servizio, un fornitore di servizi deve prima connettersi alla rete Megaport. Una volta connessi, devono:
- decidere quali delle loro connessioni dovrebbero essere utilizzate come rampe di accesso
- mappare queste posizioni di accesso alle loro regioni o zone definite dall’utente
- considerare la capacità e le zone di diversità per la gestione della ridondanza
Questo argomento descrive come tu, come fornitore di servizi, possa utilizzare le API di Megaport per ridurre lo sforzo manuale e abilitare una più rapida erogazione dei servizi. Questo renderà più facile vendere la connettività privata ai tuoi clienti.
Scenario
QuantumGPU è una piccola azienda fornitrice di servizi con sede a Los Angeles, California, che funge da piattaforma di servizio GPU-as-a-Service (GPUaaS) self-service e su richiesta. Fornendo alle aziende il calcolo accelerato dalla GPU in diverse posizioni geografiche, QuantumGPU gestisce i seguenti Port:
- 2 Port a Los Angeles, USA (Equinix LA1 e CoreSite LA1)
- 1 Port a New York, Stati Uniti (Telehouse)
- 1 Port a Londra, Regno Unito (Telehouse North)
- 1 Port a Osaka, Giappone (Equinix OS1)
- 1 Port a Sydney, Australia (Global Switch Sydney West)
QuantumGPU ha bisogno di controllare come i loro clienti si collegano ai Port e di automatizzare il processo con le API.
QuantumGPU (fornitore di servizi) prevede di implementare il seguente scenario:
Termini correlati
Assicurati di essere familiare con i seguenti termini utilizzati in questo argomento:
Megaport Cloud Router (MCR)
Il MCR è un servizio di router virtuale gestito che stabilisce la connettività Layer 3 sulla rete definita da software (SDN) a livello mondiale di Megaport. Le istanze di MCR sono preconfigurate nei data center nelle principali zone di instradamento globale. Un MCR consente il trasferimento di dati tra reti multicloud o hybrid cloud, fornitori di servizi di rete e fornitori di servizi cloud.
Megaport Virtual Edge (MVE)
Il MVE è una piattaforma di Network Function Virtualization (NFV) neutra rispetto al fornitore, disponibile su richiesta, che fornisce un’infrastruttura virtuale per i servizi di rete al bordo della rete software-defined globale (SDN) di Megaport. Le tecnologie di rete come SD-WAN e NGFW sono ospitate direttamente sulla rete globale di Megaport tramite Megaport Virtual Edge.
On-ramp
Un on-ramp è una connessione diretta e privata alle risorse disponibili di un fornitore di servizi, ad esempio, tramite una connessione Megaport. Per garantire connessioni veloci e affidabili, il fornitore di servizi mappa queste risorse alle loro regioni o zone, imposta limiti di velocità, gestisce la capacità VLAN per cliente, e così via.
Port
Una Port è l’interfaccia Ethernet ad alta velocità che si collega alla rete globale definita dal software (SDN) di Megaport. Le Port sono disponibili nelle opzioni di velocità 1 Gbps, 10 Gbps e 100 Gbps.
Diversità delle Porte
La diversità di Porta aumenta la robustezza della tua rete fornendo servizi di Porta su dispositivi fisici diversi in un’unica località Megaport. Le Porte sono assegnate a zone di diversità. Una zona di diversità raggruppa dispositivi nella stessa località per garantire che i servizi siano forniti su dispositivi fisicamente separati che rimangono sempre diversi.
Chiave del servizio
Una chiave di servizio è un codice che viene fornito da un titolare di account Megaport a un altro per collegare due aziende separate. I clienti che hanno account Megaport separati possono collegare i loro Port, MCR, o MVE tra loro attraverso la rete Megaport, consentendo VXC da azienda a azienda.
Virtual Cross Connect (VXC)
Un VXC è un circuito Ethernet Layer 2 diretto che fornisce connessioni private, flessibili e on-demand tra qualsiasi delle località sulla rete Megaport, offrendo capacità che variano da 1 Mbps a velocità multi-Gbps ad alta capacità, con fasce superiori disponibili in regioni selezionate.
Autenticazione come utente API
Prima di poter utilizzare le API di Megaport, devi autenticarti con un token di accesso. Prima di poter generare il token di accesso, devi creare una chiave API nel Megaport Portal. Per maggiori informazioni, vedere Creazione di una chiave API.
La chiave API consiste in un ID cliente e un segreto cliente. Puoi utilizzarla per generare il token di accesso che viene utilizzato per autenticarti come utente API.
I token di accesso sono validi per 24 ore e devono essere rigenerati dopo tale tempo. La tua integrazione con l’API di Megaport dovrà tenerne conto. Per maggiori informazioni, vedere Generazione di un token di accesso.
Gestione delle rampe di accesso
Quando il tuo cliente richiede una connessione a te, dovrai mappare la regione o la zona della connessione su una rampa di accesso fisica per generare la chiave di servizio.
Questa sezione descrive le chiamate API per mappare la regione o la zona di servizio dei tuoi utenti sulla tua rampa di accesso Megaport. Gli identificatori di posizione e prodotto di Megaport sono costanti, quindi possono essere memorizzati nella cache o conservati in modo sicuro senza la necessità di aggiornarli ogni volta.
Queste istruzioni descrivono come fare ciò utilizzando Postman e la raccolta di API Megaport. Per ulteriori informazioni sulla configurazione di Postman, consultare Panoramica dell’API Megaport.
Prerequisiti
Questa sezione presuppone che tu:
- abbia integrato Megaport nella tua piattaforma. Per ulteriori informazioni, consultare Integrazione di Megaport nella tua piattaforma.
- sei autenticato come utente API. Per ulteriori informazioni, vedere Autenticazione come utente API.
Elencazione delle posizioni delle rampe di accesso
Questo compito descrive come è possibile cercare e elencare le posizioni delle rampe di accesso disponibili (posizioni dei Port nel nostro scenario) utilizzando gli identificatori delle posizioni.
Per elencare le posizioni delle rampe di accesso
Nota
Questo esempio utilizza i Port, ma si possono utilizzare anche gli MCR e gli MVE.
-
Dopo che il tuo cliente richiede di collegarsi a una rampa di accesso, ad esempio un Port, utilizza l’API Get Product List con
"provisioningStatus": "LIVE"
per cercare tutti i Port live che possiedi.GET /v2/products?provisioningStatus=LIVE
-
Filtra ed elenca la risposta utilizzando il valore country.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"
Nel nostro scenario, la lista è la seguente:
- USA
- Regno Unito
- Giappone
- Australia
-
Dopo che il cliente seleziona una regione (USA), filtra e mostra la risposta in base al valore metro.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"
Nel nostro scenario, la lista è la seguente:
- Los Angeles
- New York
-
Dopo che il cliente seleziona una regione (US-West), filtra e mostra la risposta in base al valore locationId.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"
Nel nostro scenario, l’elenco è il seguente:
- “locationId”: 59
- “locationId”: 60
Mappatura di una posizione di rampa di accesso su una regione o zona definita dall’utente
È possibile utilizzare gli identificatori di posizione elencati, come locationId, metro o country e mapparli sui nomi predefiniti di regione o zona personalizzati.
Mappando le rampe di accesso disponibili, come Los Angeles 1 (“locationId”: 59) e Los Angeles 2 (“locationId”: 60), sulla regione predefinita US-West, i tuoi clienti possono selezionare US-West sulla tua piattaforma e connettersi a una rampa di accesso disponibile.
Selezione di una rampa di accesso
È possibile utilizzare le API per identificare a quale rampa di accesso collegarsi, ad esempio, per collegarsi alla porta con l’uso minimo. È possibile considerare fattori come il numero di connessioni, la capacità o l’utilizzo. Inoltre, è possibile considerare fattori come le zone di diversità per gestire la ridondanza.
Utilizza la risposta dei Port filtrati per considerare gli attributi del Port come segue:
Attributo | Considera |
---|---|
diversityZone | Controlla se la posizione attuale supporta la diversità. Per maggiori informazioni, consulta Diversità delle Porte. |
portSpeed | Controlla la velocità disponibile del Port. |
rateLimit | Il limite di velocità del VXC non può superare la velocità del Port con la velocità più bassa. Per ulteriori informazioni, consultare Panoramica delle connessioni. |
associatedVxcs | Controlla se i VXC sono associati al Port e la capacità assegnata. |
maxVxcSpeed | Controlla la velocità massima del VXC disponibile per il Port. |
vxcPermitted | Assicurati che il vxcPermitted sia vero. Se il valore di vxcPermitted è falso, non è possibile creare un VXC per quel Port. |
Dopo aver considerato i Port selezionati, puoi mostrare un Port che soddisfa i criteri richiesti, ad esempio, un Port con il minor uso. Per ulteriori informazioni, consulta Panoramica dell’API Megaport.
Gestione delle connessioni
Seguendo le migliori pratiche nella gestione delle chiavi di servizio e degli ID VLAN, è possibile mantenere connessioni organizzate e sicure.
Gestione delle chiavi di servizio
Le chiavi di servizio consentono ai clienti di stabilire connessioni con le tue specifiche rampe di accesso.
La gestione delle chiavi di servizio implica la creazione, la condivisione e il monitoraggio delle chiavi di servizio.
Questo processo è mostrato e spiegato in maggior dettaglio di seguito:
Dopo aver selezionato il servizio di rampa di accesso, puoi creare una chiave di servizio per la rampa di accesso. La creazione della chiave di servizio non ha alcun costo aggiuntivo per te, indipendentemente dal fatto che il tuo cliente utilizzi o meno la chiave.
Condividi la chiave di servizio con il tuo cliente. Facoltativamente, crea un flusso di lavoro per il tuo cliente, delineando le fasi necessarie e un tempo stimato per l’utilizzo della chiave di servizio ricevuta.
Come prerequisito, il tuo cliente deve avere un account con Megaport e avere un Port disponibile.
Utilizzando la chiave di servizio, il tuo cliente può creare un VXC e collegarsi alla rampa di accesso in base ai parametri che hai specificato. Il tuo cliente è responsabile delle spese del VXC associate alla posizione della rampa di accesso selezionata.
Utilizza l’API GET List Service Keys per monitorare continuamente e tenere traccia dello stato delle tue chiavi di servizio. Ad esempio, controlla se una chiave di servizio che hai creato e inviato a un cliente è stata utilizzata. Dopo che il tuo cliente utilizza la chiave di servizio, questa diventa obsoleta e l’ID della chiave di servizio non viene conservato. Questo significa che non esiste una connessione tra la chiave di servizio e il servizio che ha attivato.
La chiave del servizio è specifica per il servizio. Per garantire la ridondanza e la resilienza in caso di guasti o interruzioni, raccomandiamo di creare rampe di accesso situate in diverse zone di diversità. In questo caso, è necessario creare anche chiavi di servizio separate per ogni rampa di accesso, ad esempio:
- 1 chiave per Los Angeles 1 nella zona di diversità blu
- 1 chiave per Los Angeles 2 nella zona di diversità rossa
È possibile creare una chiave di servizio ad uso singolo o multiuso. Con una chiave di servizio ad uso singolo, il cliente con cui condividi la chiave può richiedere una singola connessione a una specifica rampa di accesso. Con una chiave multiuso, il cliente con cui condividi la chiave può richiedere più connessioni. In tali casi, il sistema assegna automaticamente l’ID VLAN disponibile successivo.
Gestione degli ID VLAN
Per le chiavi di servizio ad uso singolo, specifica un ID VLAN, che puoi utilizzare per collegare i clienti ai rispettivi VXC. Quando assegni un ID VLAN alla chiave di servizio, indica che il VXC assegnato è dedicato a un cliente specifico. Ogni VXC viene fornito come VLAN separata sulla tua rampa di accesso. Deve essere un ID VLAN unico su questa rampa di accesso e può variare da 2 a 4093.
La figura sottostante mostra che hai assegnato diversi ID VLAN per ciascun cliente come segue:
- ID VLAN 100 assegnato a Cliente 1
- ID VLAN 200 assegnato a Cliente 2
Gli ID VLAN (100 e 200) assegnati da te possono differire dagli ID VLAN assegnati dai tuoi clienti (123 e 10), oppure dagli ID VLAN assegnati ad altre connessioni di Porta che possiedono, come quelle ai provider di servizi cloud come AWS, Oracle o Azure (124, 125 e 20).
Per ulteriori informazioni, vedi Configurazione delle chiavi di servizio e Creazione di una Chiavi di Servizio tramite API.
Riepilogo
Questo argomento descrive come puoi gestire in modo efficiente le connessioni dei clienti ai tuoi on-ramp.
Utilizzando le API di Megaport, per cercare le Porte, selezionarle in base alla capacità, diversità e così via, puoi automatizzare il processo, riducendo il lavoro manuale e abilitando un provisioning rapido dei servizi.
Riepilogo delle API utilizzate
Questa tabella mostra il processo e le API utilizzate in questo scenario:
Nota
Questo esempio utilizza le Porte, ma lo stesso processo è utilizzato per MCR e MVE.
Azione del cliente del fornitore di servizi | Azione del fornitore di servizi | Richieste API e valori usati per il filtro | Risultato |
---|---|---|---|
Sulla piattaforma del fornitore di servizi, richiedere una connessione a un on-ramp. | Elencare le regioni con Porte, MCR o MVE attivi. | GET /v2/products? provisioningStatus=LIVE Elenca i valori "country" . |
|
Selezionare una regione (USA). | Elencare le città con Porte, MCR o MVE attivi negli USA. | GET /v2/products? provisioningStatus=LIVE &country=USA Elenca i valori “metro" |
|
Elencare le Porte a Los Angeles. Mappare le Porte disponibili, ad esempio Los Angeles 1 (“locationId”: 59) e Los Angeles 2 (“locationId”: 60), a una regione chiamata US-West. Poi, nella tua piattaforma, i clienti possono connettersi a una delle Porte disponibili in US-West. Decidere quale on-ramp offrire al cliente. Considerare capacità/utilizzo e diversità. |
GET /v2/products? provisioningStatus=LIVE &country=USA&metro=Los Angeles Elenca i valori "locationId" . |
|
|
Selezionare US-West e aggiungere diversità. | Creare le chiavi di servizio per le Porte selezionate. Inviare le chiavi di servizio al cliente. |
POST /v2/service/key Valore richiesto: "productUid" |
Vengono create 2 chiavi separate per:
“key”: “106e38ae-eb59-415f-ac81-526a5299851d”, |
Creare connessioni con le chiavi di servizio. |
Integrazione di Megaport nella tua piattaforma
Per un esempio su come integrare Megaport nella tua piattaforma, consulta il progetto demo su https://github.com/megaport/megaportgo.