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"
}
}
}