使用 API 监控服务状态
您可以通过 Postman 集合的 Product Details 文件夹中的以下请求，获取任何 Megaport 服务（例如 Port、VXC、MCR 或 MVE）的状态：
GET {baseUrl}/v2/product/{productUid}
响应会在 provisioningStatus 字段中包含该服务的开通状态。
provisioningStatus 字段可能具有以下取值：
| 预配状态 | 描述 | Port | MCR | VXC |
|---|---|---|---|---|
| NEW | 仅用于预购 Ports。此状态表示服务订单已被接受，正在等待基础设施可用。 | 此状态仅适用于 Port 预购。 该 Port 无法接受任何连接（例如 VXC），并且不会计费。 |
N/A | N/A |
| DEPLOYABLE | 服务订单已确认，正在等待部署。服务通常在此状态持续 1-2 分钟。 | |||
| CONFIGURED | 部署已完成，服务已在网络上配置。 | |||
| LIVE | 此状态的含义取决于产品。 | 已检测到该服务在网络上处于联通状态。已在 Port 上检测到光，表示已连接交叉连接并已激活该 Port。 | 从 CONFIGURED 切换到 LIVE 是瞬时完成的。 | 从 CONFIGURED 切换到 LIVE 是 瞬时完成的。 |
| CANCELLED, CANCELLED_PARENT | 已请求终止该服务。服务通常在此状态持续 1-2 分钟. | Ports 仅支持“now”终止。 | MCRs 仅支持“now”终止。 | VXCs 可以单独在“now”终止，或在终止所连接的 Port、MCR 或 MVE 时一并终止。 |
| DECOMMISSIONED | 该服务已从网络中退役。退役后 30 天将不再返回该服务。 该服务仅就退役前的实际使用时间计费。对于有期限的产品，将产生提前终止费用（ETF）。 |
|||
| FAILED | 无法部署该服务，并且不在部署队列中。 |
此外，对任何 Megaport 服务的 /v2/product/ 端点的响应还包含该服务的当前状态。根级别的 up 属性表示服务是否在线（值为 true）或离线（值为 false）。此示例展示了 VXC 的 up 属性。
{
"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"
}
}
}