Surveillance du statut des services avec l’API
Vous pouvez récupérer le statut de n’importe quel service Megaport (tel que Port, VXC, MCR, ou MVE) avec cette requête disponible dans le dossier Détails des produits de la collection Postman:
GET {baseUrl}/v2/product/{productUid}
La réponse inclut le statut de provisioning du service dans le champ provisioningStatus. Le champ provisioningStatus peut avoir les valeurs suivantes:
| Statut de Provisioning | Description | Port | MCR | VXC |
|---|---|---|---|---|
| NEW | Seulement pour les Ports en précommande. Ce statut indique que la commande du service a été acceptée et attend que l’infrastructure soit disponible. | Ce statut s’applique uniquement aux précommandes de Port. | N/A | N/A |
| DEPLOYABLE | La commande de service a été confirmée et est en attente de déploiement. Les services sont généralement dans cet état pendant 1-2 minutes. | |||
| CONFIGURED | Le déploiement est terminé et le service est configuré sur le réseau. | |||
| LIVE | La signification de ce statut dépend du produit. | Le service a été détecté comme actif sur le réseau. Une lumière a été détectée sur le Port, ce qui signifie qu’un cross connect a été attaché et le Port activé. | La transition de CONFIGURED à LIVE est instantanée. | La transition de CONFIGURED à LIVE est instantanée. |
| CANCELLED, CANCELLED_PARENT | La terminaison du service a été demandée. Les services sont généralement dans cet état pendant 1-2 minutes sauf si une date future a été fixée pour la terminaison. | Les Ports offrent deux options: 1. Terminer maintenant 2. Terminer dans 30 jours. |
Les MCRs ne supportent que la terminaison “maintenant”. | Les VXCs peuvent être terminés individuellement “maintenant” ou être terminés dans le cadre de la terminaison du Port ou de MCR attaché. Les VXCs attachés à des Ports qui doivent être terminés dans 30 jours sont terminés lorsque le Port est terminé. |
| DECOMMISSIONED | Le service a été retiré du réseau. Les services ne sont plus retournés 30 jours après leur retrait. | |||
| FAILED | Le service n’a pas pu être déployé et n’est pas dans la file d’attente de déploiement. |
De plus, la réponse à l’endpoint /v2/product/ pour tout service Megaport inclut le statut actuel du service. Le statut dans l’attribut de niveau racine up indique si le service est opérationnel (une valeur de true) ou non (une valeur de false). Cet exemple montre l’attribut up pour un 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"
}
}
}