Bereitstellungsszenarien Bereitstellungsszenarien Bereitstellungsszenarien Bereitstellungsszenarien Verwalten der Konnektivität mit Megaport-APIs als Service Provider

Verwalten der Konnektivität mit den APIs von Megaport als Service Provider

Service Provider können die Funktionen von Megaport nahtlos in ihre Plattform integrieren. Sie können den Kundenzugriff auf ihre On-Ramps steuern, zum Beispiel auf Ports.

Service Provider können einen Service Key verwenden, um den Kundenzugriff und die gesicherte Konnektivität zu ihren On-Ramps zu verwalten. Sie können spezifische Rate Limits festlegen und den Kundendatenverkehr mithilfe von VLANs segmentieren.

Ein Service Key ist ein Code, den ein Megaport-Kontoinhaber einem anderen gibt, um zwei getrennte Unternehmen miteinander zu verbinden. Kunden mit separaten Megaport-Konten können ihre Ports, MCRs oder MVEs über das Megaport-Netzwerk miteinander verbinden und so Business-to-Business-VXCs ermöglichen.

Bevor ihre Kunden mithilfe eines Service Keys eine Verbindung zu einem On-Ramp herstellen dürfen, muss ein Service Provider zunächst mit dem Netzwerk von Megaport verbunden sein. Sobald die Verbindung besteht, muss er:

entscheiden, welche seiner Verbindungen als On-Ramps verwendet werden sollen
diese On-Ramp-Standorte seinen benutzerdefinierten Regionen oder Zonen zuordnen
Kapazität und Diversität-Zonen für das Redundanzmanagement berücksichtigen

Dieses Thema beschreibt, wie Sie als Service Provider die APIs von Megaport nutzen können, um manuellen Aufwand zu reduzieren und eine schnellere Bereitstellung von Services zu ermöglichen. Dadurch wird es einfacher, private Konnektivität an Ihre Kunden zu verkaufen.

Szenario

QuantumGPU ist ein kleines Service-Provider-Unternehmen mit Hauptsitz in Los Angeles, Kalifornien, das als Self-Service-, On-Demand-GPU-as-a-Service-(GPUaaS)-Plattform dient. Um Unternehmen an verschiedenen geografischen Standorten GPU-beschleunigtes Computing bereitzustellen, betreibt QuantumGPU die folgenden Ports:

2 Ports in Los Angeles, USA (Equinix LA1 und CoreSite LA1)
1 Port in New York, USA (Telehouse)
1 Port in London, Vereinigtes Königreich (Telehouse North)
1 Port in Osaka, Japan (Equinix OS1)
1 Port in Sydney, Australien (Global Switch Sydney West)

Szenario mit den aktiven Ports, die der Service Provider besitzt

QuantumGPU muss steuern, wie sich ihre Kunden mit den Ports verbinden, und den Prozess mit APIs automatisieren.

QuantumGPU (Service Provider) plant, das folgende Szenario umzusetzen:

Authentifizierung als API-Benutzer

Bevor Sie die APIs von Megaport verwenden können, müssen Sie sich mit einem Zugriffstoken authentifizieren. Bevor Sie das Zugriffstoken generieren können, müssen Sie im Megaport Portal einen API-Schlüssel erstellen. Weitere Informationen finden Sie unter Erstellen eines API-Schlüssels.

Der API-Schlüssel besteht aus einer Client-ID und einem Client-Secret. Sie können ihn verwenden, um das Zugriffstoken zu generieren, das zur Authentifizierung als API-Benutzer verwendet wird.

Zugriffstoken sind 24 Stunden gültig und müssen danach neu generiert werden. Ihre Integration mit der Megaport-API muss dies berücksichtigen. Weitere Informationen finden Sie unter Generieren eines Zugriffstokens.

Verwalten von On-Ramps

Wenn Ihr Kunde eine Verbindung zu Ihnen anfordert, müssen Sie die Region oder Zone der Verbindung einem physischen On-Ramp zuordnen, um den Service Key zu generieren.

Dieser Abschnitt beschreibt die API-Aufrufe, um die Service-Region oder -Zone Ihrer Benutzer Ihrem Megaport On-Ramp zuzuordnen. Megaport Standort- und Produktkennungen sind konstant, sodass diese zwischengespeichert oder sicher gespeichert werden können, ohne sie jedes Mal aktualisieren zu müssen.

Diese Anleitung beschreibt, wie Sie dies mit Postman und der Megaport API Collection durchführen. Weitere Informationen zur Postman-Einrichtung finden Sie unter Megaport API-Übersicht.

Voraussetzungen

Dieser Abschnitt setzt voraus, dass Sie:

Megaport in Ihre Plattform integriert haben. Weitere Informationen finden Sie unter Integration von Megaport in Ihre Plattform.
als API-Benutzer authentifiziert sind. Weitere Informationen finden Sie unter Authentifizierung als API-Benutzer.

On-Ramp-Standorte auflisten

Diese Aufgabe beschreibt, wie Sie mithilfe der Standortkennungen Ihre verfügbaren On-Ramp-Standorte (in unserem Szenario Port-Standorte) nachschlagen und auflisten können.

So listen Sie On-Ramp-Standorte auf

Hinweis

Dieses Beispiel verwendet Ports, Sie können jedoch auch MCRs und MVEs verwenden.

Nachdem Ihr Kunde eine Verbindung zu einem On-Ramp angefordert hat, beispielsweise zu einem Port, verwenden Sie die Get Product List API mit "provisioningStatus": "LIVE", um alle Live-Ports zu suchen, die Sie besitzen.
```
GET /v2/products?provisioningStatus=LIVE
```

Filtern und listen Sie die Antwort anhand des Werts country auf.

     "locationId": 60,
     "location": "CoreSite LA1",
     "locationDetail": {
         "name": "CoreSite LA1",
         "city": "Los Angeles",
         "metro": "Los Angeles",
         "country": "USA"

In unserem Szenario lautet die Liste wie folgt:

USA
UK
Japan
Australia

Nachdem Ihr Kunde eine Region (USA) ausgewählt hat, filtern und listen Sie die Antwort anhand des Werts metro.

     "locationId": 60,
     "location": "CoreSite LA1",
     "locationDetail": {
         "name": "CoreSite LA1",
         "city": "Los Angeles",
         "metro": "Los Angeles",
         "country": "USA"

In unserem Szenario lautet die Liste wie folgt:

Los Angeles
New York

Nachdem Ihr Kunde eine Region (US-West) ausgewählt hat, filtern und listen Sie die Antwort anhand des Werts locationId.

     "locationId": 60,
     "location": "CoreSite LA1",
     "locationDetail": {
         "name": "CoreSite LA1",
         "city": "Los Angeles",
         "metro": "Los Angeles",
         "country": "USA"

In unserem Szenario ergibt sich folgende Liste:

“locationId”: 59
“locationId”: 60

Zuordnen eines On-Ramp-Standorts zu einer benutzerdefinierten Region oder Zone

Sie können die aufgelisteten Standortkennungen wie locationId, metro oder country verwenden und diese Ihren vordefinierten benutzerdefinierten Regions- oder Zonennamen zuordnen.

Indem Sie die verfügbaren On-Ramps, wie Los Angeles 1 (“locationId”: 59) und Los Angeles 2 (“locationId”: 60), der vordefinierten Region US-West zuordnen, können Ihre Kunden auf Ihrer Plattform US-West auswählen und sich mit einem verfügbaren On-Ramp verbinden.

On-Ramp auswählen

Sie können APIs verwenden, um zu bestimmen, mit welchem On-Ramp verbunden werden soll, beispielsweise um den Port mit der geringsten Nutzung auszuwählen. Dabei können Sie Faktoren wie die Anzahl der Verbindungen, Kapazität oder Auslastung berücksichtigen. Zusätzlich können Sie Faktoren wie Diversität-Zonen zur Verwaltung der Redundanz einbeziehen.

Verwenden Sie die Antwort der gefilterten Ports, um die Port-Attribute wie folgt zu berücksichtigen:

Attribut	Zu beachten
diversityZone	Prüfen Sie, ob der aktuelle Standort Diversität unterstützt. Weitere Informationen finden Sie unter Port-Diversität.
portSpeed	Prüfen Sie die verfügbare Geschwindigkeit des Ports.
rateLimit	Das VXC Rate Limit (Übertragungsratenlimit) darf die Geschwindigkeit des langsamsten Ports nicht überschreiten. Weitere Informationen finden Sie unter Übersicht zu Connections.
associatedVxcs	Prüfen Sie, ob VXCs dem Port zugeordnet sind und welche Kapazität vergeben ist.
maxVxcSpeed	Prüfen Sie die maximale für den Port verfügbare VXC-Geschwindigkeit.
vxcPermitted	Stellen Sie sicher, dass vxcPermitted auf true steht. Wenn der Wert vxcPermitted false ist, können Sie zu diesem Port kein VXC erstellen.

Nachdem Sie die ausgewählten Ports bewertet haben, können Sie einen Port anzeigen, der die erforderlichen Kriterien erfüllt, z. B. einen Port mit der geringsten Nutzung. Weitere Informationen finden Sie unter Megaport API-Übersicht.

Verwalten von Verbindungen

Durch Befolgen von Best Practices beim Verwalten der Service Keys und VLAN-IDs können Sie strukturierte und sichere Verbindungen aufrechterhalten.

Verwalten von Service Keys

Service Keys ermöglichen es Ihren Kunden, Verbindungen zu Ihren spezifischen On-Ramps herzustellen.

Das Verwalten von Service Keys umfasst das Erstellen, Weitergeben und Überwachen der Service Keys.

Dieser Prozess wird unten dargestellt und ausführlicher erklärt:

Prozess, der den unten näher erläuterten Service-Key-Workflow zeigt

Nachdem Sie den On-Ramp-Service ausgewählt haben, können Sie einen Service Key zum On-Ramp erstellen. Das Erstellen des Service Keys verursacht für Sie keine zusätzlichen Kosten, unabhängig davon, ob Ihr Kunde den Key nutzt oder nicht.

Geben Sie den Service Key an Ihren Kunden weiter. Optional können Sie für Ihren Kunden einen Workflow erstellen, der die erforderlichen Schritte und einen indikativen Zeitrahmen für die Nutzung des erhaltenen Service Keys beschreibt.

Voraussetzung ist, dass Ihr Kunde ein Konto bei Megaport hat und über einen verfügbaren Port verfügt.

Mithilfe des Service Keys kann Ihr Kunde ein VXC erstellen und sich anhand der von Ihnen festgelegten Parameter mit dem On-Ramp verbinden. Ihr Kunde ist für die VXC-Gebühren verantwortlich, die dem ausgewählten On-Ramp-Standort zugeordnet sind.

Verwenden Sie die API GET List Service Keys, um den Status Ihrer Service Keys fortlaufend zu überwachen und nachzuverfolgen. Prüfen Sie beispielsweise, ob ein von Ihnen erstellter und an einen Kunden gesendeter Service Key genutzt wurde. Nachdem Ihr Kunde den Service Key verwendet hat, wird er obsolet und die Service-Key-ID wird nicht beibehalten. Das bedeutet, dass keine Verbindung zwischen dem Service Key und dem Service besteht, den er aktiviert hat.

Der Service Key ist service-spezifisch. Um Redundanz und Resilienz bei Ausfällen oder Störungen sicherzustellen, empfehlen wir, On-Ramps in unterschiedlichen Diversität-Zonen zu erstellen. In diesem Fall müssen Sie auch separate Service Keys für jeden On-Ramp erstellen, zum Beispiel:

1 Key für Los Angeles 1 in der blauen Diversität-Zone
1 Key für Los Angeles 2 in der roten Diversität-Zone

Sie können entweder einen Service Key zur einmaligen Verwendung oder zur mehrfachen Verwendung erstellen. Mit einem Service Key zur einmaligen Verwendung kann der Kunde, mit dem Sie den Key teilen, eine einzelne Verbindung zu einem bestimmten On-Ramp anfordern. Mit einem Key zur mehrfachen Verwendung kann der Kunde, mit dem Sie den Key teilen, mehrere Verbindungen anfordern. In solchen Fällen weist das System automatisch die nächste verfügbare VLAN-ID zu.

Verwalten von VLAN-IDs

Für Service Keys zur einmaligen Verwendung geben Sie eine VLAN-ID an, die Sie verwenden können, um Kunden ihren jeweiligen VXCs zuzuordnen. Wenn Sie einem Service Key eine VLAN-ID zuweisen, zeigt dies an, dass das zugewiesene VXC einem bestimmten Kunden zugeordnet ist. Jedes VXC wird als separates VLAN an Ihrem On-Ramp bereitgestellt. Dies muss eine eindeutige VLAN-ID an diesem On-Ramp sein und kann zwischen 2 und 4093 liegen.

Das folgende Bild zeigt, dass Sie für jeden Kunden unterschiedliche VLAN-IDs wie folgt zugewiesen haben:

VLAN-ID 100 Customer 1 zugewiesen
VLAN-ID 200 Customer 2 zugewiesen

Die von Ihnen zugewiesenen VLAN-IDs (100 und 200) können sich von den von Ihren Kunden zugewiesenen VLAN-IDs (123 und 10) unterscheiden, oder von den VLAN-IDs, die anderen Port-Verbindungen Ihrer Kunden zugeordnet sind, z. B. zu Cloud Service Providern wie AWS, Oracle oder Azure (124, 125 und 20).

Szenario, das zeigt, dass die vom Service Provider zugewiesenen VLAN-IDs von den von den Kunden zugewiesenen VLAN-IDs abweichen können

Weitere Informationen finden Sie unter Einrichten von Service Keys und Erstellen eines Service Keys mit der API.

Zusammenfassung

Dieses Thema hat beschrieben, wie Sie Kundenverbindungen zu Ihren On-Ramps effizient verwalten können.

Durch die Verwendung der APIs von Megaport, um Ports nachzuschlagen, Ports basierend auf Kapazität, Diversität usw. auszuwählen, können Sie den Prozess automatisieren, den manuellen Aufwand reduzieren und eine schnelle Service-Bereitstellung ermöglichen.

Zusammenfassung der verwendeten APIs

Diese Tabelle zeigt den Prozess und die in diesem Szenario verwendeten APIs: