action.skip

APIを使用したサービスステータスの監視

Megaport の任意のサービス(Port、VXC、MCR、またはMVE など)のステータスを、Postman コレクションの Product Details フォルダーにあるこのリクエストを使用して取得できます。

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

レスポンスには、provisioningStatus フィールドにサービスのプロビジョニングステータスが含まれています。 provisioningStatus フィールドには次の値が含まれることがあります。

Provisioning Status 説明 Port MCR VXC
NEW Port の事前注文にのみ使用。このステータスはサービス注文が受理され、インフラストラクチャの利用可能を待っていることを示します。 このステータスは Port の事前注文にのみ適用されます。 該当なし 該当なし
DEPLOYABLE サービス注文が確認され、デプロイメント待ちです。通常、サービスはこの状態で1〜2分です。
CONFIGURED デプロイメントが完了し、サービスがネットワーク上で構成されました。
LIVE このステータスの意味は製品によって異なります。 サービスがネットワークでライブとして検出されました。Portで光が検出され、クロスコネクトが接続され、Portがアクティブ化されたことを意味します。 CONFIGUREDからLIVEへの移行は瞬時です。 CONFIGUREDからLIVEへの移行は瞬時です。
CANCELLED, CANCELLED_PARENT サービスの終了が要求されました。通常、サービスはこの状態で1〜2分です。ただし、終了のための将来の日付が設定されている場合を除きます。 Portは2つのオプションを提供します:
1. 今すぐ終了
2. 30日後に終了。
MCRは「今すぐ」終了のみをサポートします。 VXCは個別に「今すぐ」終了できます。 または、接続されているPortまたはMCRを終了する一環として終了されます。30日後に終了するよう設定されているPortsに接続されているVXCは、そのPortが終了する際に終了されます。
DECOMMISSIONED サービスはネットワークから廃止されました。廃止後30日以内にサービスは返されません。
FAILED サービスをデプロイできず、デプロイメントキューにありません。

さらに、任意のMegaportサービスに対する/v2/product/エンドポイントへのレスポンスには、サービスの現在のステータスが含まれています。ルートレベルのup属性のステータスは、サービスがアップ(true の値)かダウン(false の値)かを示します。この例は、VXCのup属性を示しています。

{
    "message": "Product 9fbc4f9e-5f59-458e-bb95-6633e77ab121 が見つかりました",
    "terms": "このデータは利用可能な使用条件の対象となります 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"
        }
    }
}