action.skip
Megaport Documentation
Erstellen eines Ports
Copy for LLM ▼
Copy Page Content Open in ChatGPT Open in Claude Open in VS Code View Markdown
PDF

Erstellen eines Ports mit der API

Dieses Thema beschreibt das API-Verfahren zum Erstellen eines Ports, einschließlich der Suche nach Port-Standorten, der Validierung des Ports und der Ermittlung der Kosten, der Bestellung des Ports sowie dem Herunterladen der Letter of Authorization (LOA)Ein Letter of Authorization (LOA) ist ein Dokument, das Kunden ihrem Rechenzentrumsanbieter vorlegen müssen, um den physischen Cross-Connect von ihren Rechenzentrumsdiensten zu ihrem Port herzustellen. Die LOA wird über das Megaport Portal bereitgestellt, wenn ein Kunde einen neuen Port provisioniert.
.

Bevor Sie beginnen, besorgen Sie sich ein gültiges Access Token. Weitere Informationen finden Sie unter Erstellen eines API-Schlüssels.

So rufen Sie Port-Standortdetails in der Postman-Collection ab

  1. Klicken Sie in der linken Navigation auf Locations und klicken Sie auf GET Locations (v3).
    Diese Anforderung erwartet keine Parameter- oder Body-Informationen.

  2. Klicken Sie auf Send, um die Anforderung zu senden.

    GET {baseUrl}/v3/locations

    Standorte abrufen

    Stellen Sie sicher, dass die Anforderung erfolgreich war, indem Sie nach Status: 200 OK suchen, und zeigen Sie die Antwort im Abschnitt Body im Pretty-Format an.

    Die Anforderung liefert Hunderte von Port-Standorten. Sie können suchen, indem Sie auf die Lupe klicken und eine bestimmte Stadt, ein Rechenzentrum oder einen anderen Parameter in das Suchfeld eingeben. In diesem Beispiel wird der Standort Digital Realty, London verwendet. 

{
            "id": 89,
            "name": "Digital Realty London LHR20",
            "address": {
                "street": "227 Marsh Wall",
                "suburb": null,
                "city": "London",
                "state": null,
                "postcode": "E14 9SD",
                "country": "United Kingdom"
            },
            "dataCentre": {
                "id": 3,
                "name": "Digital Realty"
            },
            "metro": "London",
            "market": "UK",
            "status": "Active",
            "longitude": -0.012144,
            "latitude": 51.499714,
            "orderingMessage": null,
            "diversityZones": {
                "red": {
                    "mcrSpeedMbps": [
                        5000,
                        100000,
                        1000,
                        25000,
                        10000,
                        2500,
                        50000
                    ],
                    "megaportSpeedMbps": [
                        100000,
                        10000,
                        1000
                    ],
                    "mveMaxCpuCoreCount": null,
                    "mveAvailable": true
                },
                "blue": {
                    "mcrSpeedMbps": [
                        1000,
                        2500,
                        5000,
                        10000
                    ],
                    "megaportSpeedMbps": [
                        1000,
                        10000,
                        100000
                    ],
                    "mveMaxCpuCoreCount": null,
                    "mveAvailable": true
                }
            },
            "productAddOns": {
                "crossConnect": {
                    "available": false,
                    "type": null
                }
            }
        }

Um einen Port zu erstellen, benötigen Sie den Wert market und die id. In diesem Beispiel ist der Markt UK und die Data-Centre-ID 89.

So testen und validieren Sie die Port-Bestellung

  1. In Postman öffnen Sie den Ordner Ports in der linken Navigation und wählen POST Port-Bestellung validieren (v3) aus.

  2. Aktualisieren Sie den Body mit locationId (89), term (Monate: 1, 12, 24 oder 36), productName (gewünschter Name), portSpeed (1000, 10000 oder 100000 Mbps) und market (UK) und klicken Sie auf Senden. 

[
  {
    "locationId": 89,
    "term": 1,
    "locationUid": null,
    "productName": "API Port",
    "productType": "MEGAPORT",
    "createDate": 1452475039656,
    "portSpeed": 1000,
    "virtual": false,
    "promoCode": "promox3mnthfree2",
    "market": "UK"
  }
]

Eine erfolgreiche Antwort besteht die Validierung und hat den HTTP-Status 200 OK. Die Antwort enthält außerdem Preisinformationen für den Dienst.

{
    "message": "Validation passed",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
        {
            "price": {
                "hourlySetup": 0,
                "dailySetup": 0,
                "monthlySetup": 0,
                "hourlyRate": 0,
                "dailyRate": 0,
                "monthlyRate": 500.00,
                "fixedRecurringCharge": 500.00,
                "postPaidBaseRate": "no base rate",
                "longHaulMbpsRate": 0,
                "mbpsRate": 0,
                "currency": "GBP",
                "key": "no key",
                "productType": "MEGAPORT",
                "empty": false
            },
            "serviceName": "API Port",
            "productType": "MEGAPORT",
            "productUid": "f9859fd3-344d-4a33-8cd2-a3b6ebfaaef0",
            "market": "UK",
            "string": "London"
        }
    ]
}

So bestellen Sie den validierten Port

  1. Mit einer validierten Port-Anforderung und geprüften Kostendaten kopieren Sie den Body aus POST Validate Port Order (v3) und fügen ihn in den Body von POST Buy Port (v3) ein.

    Wichtig

    Wenn Sie diesen Aufruf auf api.megaport.com durchführen, wird Ihr Konto für den Dienst belastet. Alternativ können Sie wie in diesen Beispielen gegen die Staging-API bereitstellen, ohne dass Gebühren anfallen.

  2. Senden Sie die Anforderung.
    Eine erfolgreiche Antwort enthält eine technicalServiceUid, die identisch mit der productUid ist.
    In unserem Beispiel ist dieser Wert a49cf3f1-20a1-4390-93aa-5005bdafe3d7.

{
    "message": "MEGAPORT [a49cf3f1-20a1-4390-93aa-5005bdafe3d7] created. ",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
        {
            "serviceName": "API Port",
            "name": "API Port",
            "secondaryName": null,
            "technicalServiceId": 68124,
            "technicalServiceUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
            "requestedDate": 1588862976322,
            "configuredDate": null,
            "currentEstimatedDelivery": null,
            "companyName": "Megaport Lab",
            "companyId": 2278,
            "aggregationId": null,
            "lagPrimary": false,
            "billingContactName": null,
            "billingContactId": null,
            "adminContactName": null,
            "adminContactId": null,
            "technicalContactName": null,
            "technicalContactId": null,
            "salesName": null,
            "salesId": null,
            "billableId": 56333,
            "billableUsageAlgorithm": "NOT_POST_PAID",
            "productType": "MEGAPORT",
            "provisioningStatus": "DEPLOYABLE",
            "inAdvanceBillingStatus": "NOT_ACTIVATED",
            "provisioningItems": [],
            "tags": [],
            "vxcDistanceBand": null,
            "intercapPath": null,
            "marketplaceVisibility": true,
            "vxcPermitted": true,
            "vxcAutoApproval": false,
            "createDate": 1588862976322,
            "terminationDate": null,
            "contractStartDate": 1588860000000,
            "contractTermMonths": 1,
            "rateType": "MONTHLY",
            "trialAgreement": false,
            "payerCompanyId": null,
            "nonPayerCompanyId": null,
            "minimumSpeed": null,
            "maximumSpeed": null,
            "rateLimit": 10000,
            "errorMessage": null,
            "market": "UK",
            "accountManager": null,
            "promptUid": null,
            "components": [],
            "attributes": [],
            "aLocation": null,
            "bLocation": null,
            "aLocationId": null,
            "bLocationId": null,
            "attributeTags": {},  
            "createdBy":  "a51cc1c6-95a0-48c7-a5a0-e49d77a6c536",
            "buyoutPort": false,
            "virtual": false,
            "locked": false,
            "adminLocked": false
        }
    ]
}

Der neue Port erscheint nun in Ihrer Arbeitsumgebung, entweder portal.megaport.com oder portal-staging.megaport.com.

Neuer API-Port

Tipp

Um alle Optionen für die in diesem Beispiel verwendeten Anfragen zu sehen, siehe https://dev.megaport.com.

Letter of Authorization (LOA) herunterladen

Nachdem Sie Ihren Port erstellt haben, können Sie die LOA herunterladen.

Hinweis

Bevor Sie die LOA herunterladen können, muss der Provisioning Status des Ports auf Configured stehen.

So laden Sie die LOA herunter

  1. Erweitern Sie in Postman in der linken Navigation Ports und wählen Sie GET Regenerate LOA for Megaport Service aus.

  2. Ersetzen Sie im GET-Befehl die productID durch den Wert, der während der Port-Erstellung erzeugt wurde.

  3. Senden Sie die Anforderung.

    Bei einer erfolgreichen 200 OK-Antwort erscheint im Abschnitt Body diese Meldung: 

    This response could not be previewed. 
Download the response to open it with an appropriate application.

    Diese Meldung erscheint, weil die LOA ein PDF-Dokument ist und heruntergeladen werden muss. Zum Herunterladen klicken Sie in Postman auf Save Response und speichern die PDF an einem geeigneten Ort.