Criando um MCR com a API
Este tópico descreve o procedimento da API para criar um MCR, incluindo como pesquisar locais para o MCR, e como validar e concluir o pedido.
Antes de começar, obtenha um token de acesso válido. Para mais informações, consulte Criando uma chave de API.
Para pesquisar os detalhes de localização do MCR na coleção do Postman
-
Expanda a pasta Locations (Localizações) na navegação à esquerda e clique em GET Locations (v3) (GET Localizações (v3)).
Esta solicitação não espera informações de Parâmetros ou Corpo. -
Clique em Send (Enviar) para fazer uma solicitação GET.
GET {baseUrl}/v3/locations
Confirme que a solicitação foi bem-sucedida procurando pelo Status: 200 OK e exiba a resposta na seção Body no formato Pretty.
A solicitação retorna centenas de locais da Megaport.
-
Clique na lupa e pesquise na resposta por um local que inclua
mcrSpeedMbpsno objetodiversityZonese que esteja no mercado dos EUA.Para provisionar um MCR em um local, a velocidade da porta deve estar disponível no objeto
diversityZones. Verifique se o local possui a velocidade e a zona de diversidade disponíveis para o MCR.
{
"id": 60,
"name": "CoreSite LA1",
"address": {
"street": "624 South Grand Avenue",
"suburb": null,
"city": "Los Angeles",
"state": "CA",
"postcode": "90017",
"country": "USA"
},
"dataCentre": {
"id": 18,
"name": "CoreSite"
},
"metro": "Los Angeles",
"market": "US",
"status": "Active",
"longitude": -118.25554,
"latitude": 34.04791,
"orderingMessage": null,
"diversityZones": {
"red": {
"mcrSpeedMbps": [
2500,
5000,
10000,
1000
],
"megaportSpeedMbps": [
1000,
10000,
100000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
},
"blue": {
"mcrSpeedMbps": [
5000,
1000,
2500,
10000
],
"megaportSpeedMbps": [
1000,
100000,
10000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
}
},
"productAddOns": {
"crossConnect": {
"available": true,
"type": "STANDARD"
}
}
}
Para criar um MCR, você precisa do valor id. Neste exemplo, o ID de localização é 60.
Para testar e validar o pedido de MCR
-
No Postman, expanda Megaport Cloud Router (MCR) (Megaport Cloud Router (MCR)) na navegação à esquerda e selecione Validate MCR Order (v3) (Validar Pedido de MCR (v3)).
-
Atualize o Body com o
locationId(60),productName(qualquer nome que você queira para seu MCR),term(o número mínimo de meses no prazo contratado: 1, 12, 24, 36, 48 ou 60) eportSpeed(1000, 2500, 5000 ou 10000 Mbps) e clique em Send (Enviar).
Um valor ASN só é necessário se você não quiser usar o ASN padrão da Megaport de 133937.
Adicione uma zona de diversidade. Verifique os resultados de localização para ver quais zonas de diversidade estão disponíveis para sua localização do MCR emdiversityZones.
Se a zona de diversidade não for explicitamente selecionada, uma será automaticamente alocada quando o MCR for criado.POST {baseUrl}/v3/networkdesign/validate
[
{
"locationId":60,
"term": 12,
"promoCode": "promox3mnthfree2",
"productName":"Test MCR",
"productType":"MCR2",
"portSpeed":2500,
"config": {
"mcrAsn": 133937,
"diversityZone":"blue"
}
}
]
Uma resposta bem-sucedida passa na validação e tem status 200 OK. A resposta também inclui detalhes de preços do serviço.
{
"message": "Validation passed",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"price": {
"hourlySetup": 0,
"dailySetup": 0,
"monthlySetup": 0,
"hourlyRate": 0,
"dailyRate": 0,
"monthlyRate": 1440.00,
"fixedRecurringCharge": 0,
"postPaidBaseRate": "no base rate",
"longHaulMbpsRate": 0,
"mbpsRate": 6.000000000000000,
"currency": "USD",
"key": "no key",
"productType": "MCR2",
"empty": false
},
"serviceName": "API Test MCR",
"productType": "MCR2",
"productUid": "78aebd6b-7601-4331-82bc-dcd07f9f21a6",
"string": "Los Angeles"
}
]
}
Para solicitar o MCR validado
-
Com uma solicitação de MCR validada e informações de custo revisadas, copie o Body de POST Validate MCR Order (v3) (POST Validar Pedido de MCR (v3)) e cole no Body de POST Buy MCR (v3) (POST Comprar MCR (v3)).
Importante
Se você fizer essa chamada em api.megaport.com, sua conta será cobrada pelo serviço. Como alternativa, você pode usar a API no ambiente de staging (teste) sem cobranças, como nestes exemplos.
-
Envie a solicitação.
Esta saída mostra uma resposta bem-sucedida.
{
"message": "MCR2 [426fa830-4b66-41ad-95a1-197d55e074b1] created.",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"serviceName": "Test MCR",
"name": "Test MCR",
"secondaryName": null,
"technicalServiceId": 187964,
"technicalServiceUid": "426fa830-4b66-41ad-95a1-197d55e074b1",
"requestedDate": 1707800936928,
"configuredDate": null,
"currentEstimatedDelivery": null,
"companyName": "Megaport Lab",
"companyId": 1153,
"billingContactName": null,
"billingContactId": null,
"adminContactName": null,
"adminContactId": null,
"technicalContactName": null,
"technicalContactId": null,
"salesName": null,
"salesId": null,
"billableId": 179527,
"billableUsageAlgorithm": null,
"productType": "MCR2",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": null,
"intercapPath": null,
"marketplaceVisibility": false,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1707800936928,
"terminationDate": null,
"contractStartDate": null,
"contractTermMonths": 12,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 2500,
"errorMessage": null,
"lagId": null,
"aggregationId": null,
"lagPrimary": null,
"market": "USA",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": "lax-cs1",
"bLocation": null,
"aMetro": "Los Angeles",
"aCountry": "USA",
"aLocationId": 60,
"bLocationId": null,
"bMetro": null,
"bCountry": null,
"attributeTags": {},
"createdBy": "f39b8983-256e-4643-adec-9f0b5da09ab7",
"buyoutPort": false,
"virtual": true,
"locked": false,
"adminLocked": false,
"bgpShutdownDefault": false,
"originDomain": null
}
]
}
O novo MCR agora aparece no seu ambiente de trabalho, seja portal.megaport.com ou portal-staging.megaport.com.
Dica
Para ver todas as opções das solicitações usadas neste exemplo, consulte https://dev.megaport.com.
A próxima etapa é criar VXCs para este MCR.
Para mais informações, consulte: