Monitorando o status do serviço com a API
Você pode recuperar o status de qualquer serviço Megaport (como Port, VXC, MCR, ou MVE) com esta requisição disponível na pasta Product Details da coleção do Postman:
GET {baseUrl}/v2/product/{productUid}
A resposta inclui o status de provisionamento do serviço no campo provisioningStatus.
O campo provisioningStatus pode ter os seguintes valores:
| Provisioning Status (Status de provisionamento) | Description (Descrição) | Port | MCR | VXC |
|---|---|---|---|---|
| NEW | Apenas para pré-pedido de Ports. Este status indica que o pedido do serviço foi aceito e está aguardando a disponibilidade da infraestrutura. | Este status se aplica apenas a pré-pedidos de Port. O Port não pode aceitar nenhuma conexão (como um VXC) e não é faturado. |
N/A | N/A |
| DEPLOYABLE | O pedido do serviço foi confirmado e está aguardando a implantação. Os serviços geralmente ficam nesse estado por 1-2 minutos. | |||
| CONFIGURED | A implantação foi concluída e o serviço está configurado na rede. | |||
| LIVE | O significado deste status depende do produto. | O serviço foi detectado como ativo na rede. Foi detectado sinal óptico no Port, o que significa que um cross connect foi conectado e o Port ativado. | A transição de CONFIGURED para LIVE é instantânea. | A transição de CONFIGURED para LIVE é instantânea. |
| CANCELLED, CANCELLED_PARENT | O encerramento do serviço foi solicitado. Os serviços geralmente ficam nesse estado por 1-2 minutos, a menos que tenha sido definida uma data futura para o encerramento. | Ports oferecem duas opções: 1. Encerrar agora 2. Encerrar em 30 dias. |
Os MCRs oferecem suporte apenas ao encerramento “agora”. | Os VXCs podem ser encerrados individualmente “agora” ou são encerrados como parte do encerramento do Port ou do MCR. Os VXCs anexados a Ports configurados para encerrar em 30 dias são encerrados quando o Port é encerrado. |
| DECOMMISSIONED | O serviço foi descomissionado da rede. Os serviços não são mais retornados 30 dias após serem descomissionados. O serviço é faturado apenas pelo período em que esteve em uso antes de ser descomissionado. Produtos com prazo contratual incorrerão em taxas de rescisão antecipada (ETF). |
|||
| FAILED | O serviço não pôde ser implantado e não está na fila de implantação. |
Além disso, a resposta do endpoint /v2/product/ para qualquer serviço Megaport inclui o status atual do serviço. O status no atributo up no nível raiz indica se o serviço está ativo (valor true) ou inativo (valor false). Este exemplo mostra o atributo up para um 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"
}
}
}