Creación de un MCR con la API
Este tema describe el procedimiento de la API para crear un MCR, incluido cómo buscar ubicaciones para el MCR y cómo validar y completar el pedido.
Antes de comenzar, obtén un token de acceso válido. Para obtener más información, consulta Creación de una clave de API.
Para buscar los detalles de ubicación de MCR en la colección de Postman
-
Expande la carpeta Locations (Ubicaciones) en la navegación izquierda y haz clic en GET Locations (v3) (Obtener ubicaciones (v3)).
Esta solicitud no espera información de Parameters ni Body. -
Haz clic en Send (Enviar) para realizar una solicitud GET.
GET {baseUrl}/v3/locations
Asegúrate de que la solicitud se haya realizado correctamente buscando Status: 200 OK y muestra la respuesta en la sección Body en el formato Pretty.
La solicitud devuelve cientos de ubicaciones de Megaport.
-
Haz clic en la lupa y busca en la respuesta un sitio que incluya
mcrSpeedMbpsen el objetodiversityZonesy que esté en el mercado de EE. UU.Para aprovisionar un MCR en una ubicación, la velocidad del puerto debe estar disponible en el objeto
diversityZones. Verifica que la ubicación tenga la velocidad y la zona de diversidad disponibles para el 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 crear un MCR, necesitas el valor id. En este ejemplo, el ID de la ubicación es 60.
Para probar y validar el pedido del MCR
-
En Postman, expande Megaport Cloud Router (MCR) en la navegación izquierda y selecciona Validate MCR Order (v3).
-
Actualiza el Body con el
locationId(60),productName(el nombre que quieras para tu MCR),term(la duración mínima en meses del plazo comprometido: 1, 12, 24, 36, 48 o 60) yportSpeed(1000, 2500, 5000 o 10000 Mbps) y haz clic en Send (Enviar).
Un valor ASN solo es necesario si no deseas usar el ASN predeterminado de Megaport (133937).
Añade una zona de diversidad. Comprueba los resultados de la ubicación para ver qué zonas de diversidad están disponibles para tu MCR bajodiversityZones.
Si no se selecciona explícitamente la zona de diversidad, se asignará automáticamente cuando se cree el MCR.
[
{
"locationId":60,
"term": 12,
"promoCode": "promox3mnthfree2",
"productName":"Test MCR",
"productType":"MCR2",
"portSpeed":2500,
"config": {
"mcrAsn": 133937,
"diversityZone":"blue"
}
}
]
Una respuesta satisfactoria supera la validación y devuelve un estado 200 OK. La respuesta también incluye detalles de precios del servicio.
{
"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 el MCR validado
-
Con una solicitud de MCR validada y tras revisar la información de costes, copia el Body de POST Validate MCR Order (v3) y pégalo en el Body de POST Buy MCR (v3).
Importante
Si realiza esta llamada en api.megaport.com, su cuenta será cargada por el servicio. Alternativamente, puede usar la API en el entorno de staging (pruebas) sin cargos, como en estos ejemplos.
-
Envíe la solicitud.
La salida siguiente muestra una respuesta exitosa.
{
"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
}
]
}
El nuevo MCR ahora aparece en tu entorno de trabajo, ya sea portal.megaport.com o portal-staging.megaport.com.
Consejo
Para ver todas las opciones de las solicitudes usadas en este ejemplo, consulta https://dev.megaport.com.
El siguiente paso es crear VXCs hacia este MCR.
Para obtener más información, consulta: