Copy for LLM ▼

Copy Page Content Open in ChatGPT Open in Claude Open in VS Code View Markdown

PDF

Überwachung des Service-Status mit der API

Sie können den Status eines beliebigen Megaport-Services (z. B. Port, VXC, MCR, oder MVE) mit dieser Anfrage abrufen, die im Ordner Product Details der Postman-Collection verfügbar ist:

GET {baseUrl}/v2/product/{productUid}

Die Antwort enthält den Bereitstellungsstatus des Service im Feld provisioningStatus. Das Feld provisioningStatus kann die folgenden Werte haben:

Bereitstellungsstatus	Beschreibung	Port	MCR	VXC
NEW	Nur für die Vorbestellung von Ports. Dieser Status zeigt an, dass der Serviceauftrag angenommen wurde und auf die Verfügbarkeit der Infrastruktur wartet.	Dieser Status gilt nur für Port-Vorbestellungen. Der Port kann keine Verbindungen (z. B. eine VXC) annehmen und wird nicht abgerechnet.	N/A	N/A
DEPLOYABLE	Der Serviceauftrag wurde bestätigt und wartet auf die Bereitstellung. Dienste befinden sich typischerweise 1-2 Minuten in diesem Zustand.
CONFIGURED	Die Bereitstellung wurde abgeschlossen und der Dienst ist im Netzwerk konfiguriert.
LIVE	Die Bedeutung dieses Status hängt vom Produkt ab.	Der Dienst wurde im Netzwerk als live erkannt. Auf dem Port wurde Licht erkannt, was bedeutet, dass ein Cross-Connect angeschlossen und der Port aktiviert wurde.	Der Übergang von CONFIGURED zu LIVE ist sofortig.	Der Übergang von CONFIGURED zu LIVE ist sofortig.
CANCELLED, CANCELLED_PARENT	Die Beendigung des Dienstes wurde angefordert. Dienste befinden sich in der Regel 1-2 Minuten in diesem Zustand, es sei denn, für die Beendigung wurde ein zukünftiges Datum festgelegt.	Ports bieten zwei Optionen: 1. Jetzt beenden 2. In 30 Tagen beenden.	MCRs unterstützen nur die Beendigung „jetzt“.	VXCs können einzeln „jetzt“ beendet werden oder werden im Rahmen der Beendigung des angeschlossenen Ports oder MCR beendet. VXCs, die an Ports angeschlossen sind, die auf Beendigung in 30 Tagen gesetzt sind, werden beendet, wenn der Port beendet wird.
DECOMMISSIONED	Der Dienst wurde aus dem Netzwerk außer Betrieb genommen. Dienste werden 30 Tage nach ihrer Außerbetriebnahme nicht mehr zurückgegeben. Der Dienst wird nur für die Zeit abgerechnet, in der er vor der Außerbetriebnahme in Gebrauch war. Produkte mit Laufzeit verursachen vorzeitige Kündigungsgebühren (ETF).
FAILED	Der Dienst konnte nicht bereitgestellt werden und befindet sich nicht in der Bereitstellungswarteschlange.

Darüber hinaus enthält die Antwort auf den Endpoint /v2/product/ für jeden Megaport-Service den aktuellen Status des Service. Der Status im Root-Level-Attribut up gibt an, ob der Service up (Wert true) oder down (Wert false) ist. Dieses Beispiel zeigt das Attribut up für eine VXC.

{
    "message": "Found Product 9fbc4f9e-5f59-458e-bb95-6633e77ab121",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": {
        "productId": 220451,
        "productUid": "9fbc4f9e-5f59-458e-bb95-6633e77ab121",
        "productName": "WEST AWS",
        "secondaryName": null,
        "productType": "VXC",
        "rateLimit": 50,
        "maximumRate": 10000,
        "distanceBand": "METRO",
        "provisioningStatus": "LIVE",
        "usageAlgorithm": "POST_PAID_VARIABLE",
        "createdBy": "cb9c4d7e-4cd2-4f6b-4f4e-89ab263e57e4",
        "liveDate": 1733253865042,
        "createDate": 1733253767229,
        "resources": {
            "csp_connection": {
                "bandwidth": 50,
                "connectType": "AWSHC",
                "resource_name": "b_csp_connection",
                "resource_type": "csp_connection",
                "name": "WEST AWS",
                "ownerAccount": "206049248854",
                "bandwidths": [
                    50
                ],
                "connectionId": "dxcon-fftxgi4j"
            },
            "vll": {
                "a_vlan": 2612,
                "b_vlan": 2612,
                "rate_limit_mbps": 50,
                "resource_name": "vll",
                "resource_type": "vll",
                "up": 1,
                "shutdown": false
            }
        },
        "vxcApproval": {
            "status": null,
            "message": null,
            "uid": null,
            "type": null,
            "newSpeed": null
        },
        "contractStartDate": 1733253865055,
        "contractEndDate": 1735912800000,
        "contractTermMonths": 12,
        "companyUid": "160408ae-01e4-4cb9-8d57-03a147bd47a8",
        "companyName": "Megaport Test",
        "locked": false,
        "adminLocked": false,
        "attributeTags": {},
        "up": true,
        "shutdown": false,
        "cancelable": true,
        "aEnd": {
            "ownerUid": "160408ae-01e4-4cb9-8d57-03a147bd47a8",
            "productUid": "21be60a4-14c8-454f-9636-c6a4ad9f8447",
            "productName": "ZW TEST",
            "locationId": 147,
            "location": "CyrusOne Chandler",
            "locationDetail": {
                "name": "CyrusOne Chandler",
                "city": "Phoenix",
                "metro": "Phoenix",
                "country": "USA"
            },
            "vlan": 2612,
            "innerVlan": null,
            "secondaryName": null,
            "connectType": "DEFAULT",
            "diversityZone": "red"
        },
        "bEnd": {
            "ownerUid": "605cb840-dfb4-4a05-a171-8bf17757b4a2",
            "productUid": "d2b92be4-d85c-4ae5-b511-37c1cfe6e146",
            "productName": "US West (N. California) (us-west-1)",
            "locationId": 370,
            "location": "PhoenixNAP",
            "locationDetail": {
                "name": "PhoenixNAP",
                "city": "Phoenix",
                "metro": "Phoenix",
                "country": "USA"
            },
            "vlan": 2612,
            "innerVlan": null,
            "secondaryName": null,
            "connectType": "AWSHC",
            "diversityZone": "red"
        }
    }
}