Creación de un Port con la API
Este tema describe el procedimiento de la API para crear un Port, incluido cómo consultar ubicaciones de Port, validar el Port y determinar el costo, solicitar el Port y descargar la Carta de Autorización (LOA)Una Carta de Autorización (LOA) es un documento que los clientes deben presentar a su proveedor de centro de datos para establecer el cross-connect físico desde sus servicios de centro de datos hasta su Port. La LOA se proporciona a través del Megaport Portal cuando un cliente aprovisiona un nuevo Port.
.
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 consultar los detalles de la ubicación de Port en la colección de Postman
-
Haz clic en Locations (Ubicaciones) en la navegación izquierda y haz clic en GET Locations (v3) (GET Ubicaciones (v3)).
Esta solicitud no espera información en Parameters ni en Body. -
Haz clic en Send (Enviar) para realizar la solicitud.
GET {baseUrl}/v3/locations
Asegúrate de que la solicitud se haya realizado correctamente buscando Estado: 200 OK y muestra la respuesta en la sección Body en el formato Pretty.
La solicitud devuelve cientos de ubicaciones de Port. Puedes buscar haciendo clic en la lupa e ingresando una ciudad específica, un centro de datos u otro parámetro en el campo de búsqueda. Este ejemplo usa la ubicación Digital Realty, Londres.
{
"id": 89,
"name": "Digital Realty London LHR20",
"address": {
"street": "227 Marsh Wall",
"suburb": null,
"city": "London",
"state": null,
"postcode": "E14 9SD",
"country": "United Kingdom"
},
"dataCentre": {
"id": 3,
"name": "Digital Realty"
},
"metro": "London",
"market": "UK",
"status": "Active",
"longitude": -0.012144,
"latitude": 51.499714,
"orderingMessage": null,
"diversityZones": {
"red": {
"mcrSpeedMbps": [
5000,
100000,
1000,
25000,
10000,
2500,
50000
],
"megaportSpeedMbps": [
100000,
10000,
1000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
},
"blue": {
"mcrSpeedMbps": [
1000,
2500,
5000,
10000
],
"megaportSpeedMbps": [
1000,
10000,
100000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
}
},
"productAddOns": {
"crossConnect": {
"available": false,
"type": null
}
}
}
Para crear un Port, necesitas el valor market y el valor id. En este ejemplo, el market es UK y el ID del centro de datos es 89.
Para probar y validar el pedido de Port
-
En Postman, abre la carpeta Ports en la navegación izquierda y selecciona POST Validate Port Order (v3).
-
Actualiza el Body con el
locationId(89),term(número de meses - 1, 12, 24, 36, 48 o 60),productName(cualquier nombre que desees para tu Port),portSpeed(1000, 10000 o 100000 Mbps) ymarket(UK) y haz clic en Send (Enviar).
[
{
"locationId": 89,
"term": 1,
"locationUid": null,
"productName": "API Port",
"productType": "MEGAPORT",
"createDate": 1452475039656,
"portSpeed": 1000,
"virtual": false,
"promoCode": "promox3mnthfree2",
"market": "UK"
}
]
Una respuesta satisfactoria supera la validación y tiene un estado 200 OK. La respuesta también incluye los 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": 500.00,
"fixedRecurringCharge": 500.00,
"postPaidBaseRate": "no base rate",
"longHaulMbpsRate": 0,
"mbpsRate": 0,
"currency": "GBP",
"key": "no key",
"productType": "MEGAPORT",
"empty": false
},
"serviceName": "API Port",
"productType": "MEGAPORT",
"productUid": "f9859fd3-344d-4a33-8cd2-a3b6ebfaaef0",
"market": "UK",
"string": "London"
}
]
}
Para solicitar el Port validado
-
Con una solicitud de Port validada y la información de costos revisada, copia el Body de POST Validate Port Order (v3) (POST Validar pedido de Port (v3)) y pégalo en el Body de POST Buy Port (v3) (POST Comprar Port (v3)).
Importante
Si realizas esta llamada en api.megaport.com, se cargará el servicio a tu cuenta. Alternativamente, puedes aprovisionar contra la API de staging sin cargos, como en estos ejemplos.
-
Envía la solicitud.
Una respuesta satisfactoria incluye untechnicalServiceUid, que es el mismo que elproductUid.
Para nuestro ejemplo, este valor es a49cf3f1-20a1-4390-93aa-5005bdafe3d7.
{
"message": "MEGAPORT [a49cf3f1-20a1-4390-93aa-5005bdafe3d7] created. ",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"serviceName": "API Port",
"name": "API Port",
"secondaryName": null,
"technicalServiceId": 68124,
"technicalServiceUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"requestedDate": 1588862976322,
"configuredDate": null,
"currentEstimatedDelivery": null,
"companyName": "Megaport Lab",
"companyId": 2278,
"aggregationId": null,
"lagPrimary": false,
"billingContactName": null,
"billingContactId": null,
"adminContactName": null,
"adminContactId": null,
"technicalContactName": null,
"technicalContactId": null,
"salesName": null,
"salesId": null,
"billableId": 56333,
"billableUsageAlgorithm": "NOT_POST_PAID",
"productType": "MEGAPORT",
"provisioningStatus": "DEPLOYABLE",
"inAdvanceBillingStatus": "NOT_ACTIVATED",
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": null,
"intercapPath": null,
"marketplaceVisibility": true,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1588862976322,
"terminationDate": null,
"contractStartDate": 1588860000000,
"contractTermMonths": 1,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 10000,
"errorMessage": null,
"market": "UK",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": null,
"bLocation": null,
"aLocationId": null,
"bLocationId": null,
"attributeTags": {},
"createdBy": "a51cc1c6-95a0-48c7-a5a0-e49d77a6c536",
"buyoutPort": false,
"virtual": false,
"locked": false,
"adminLocked": false
}
]
}
El nuevo Port ahora aparece en tu entorno de trabajo, ya sea portal.megaport.com o portal-staging.megaport.com.
Consejo
Para ver todas las opciones para las solicitudes utilizadas en este ejemplo, consulta https://dev.megaport.com.
Descargar la Carta de Autorización (LOA)
Después de crear tu Port, puedes descargar la LOA.
Nota
Antes de poder descargar la LOA, el estado de aprovisionamiento del Port debe ser Configured.
Para descargar la LOA
-
En Postman, expande Ports (Ports) en la navegación izquierda y selecciona GET Regenerate LOA for Megaport Service (GET Regenerar LOA para el servicio Megaport).
-
En el comando GET, reemplaza el
productIDpor el valor creado durante la creación del Port. -
Envía la solicitud.
Con una respuesta 200 OK satisfactoria, aparece este mensaje en la sección Body:
Esta respuesta no se pudo previsualizar. Descarga la respuesta para abrirla con una aplicación apropiada.Este mensaje aparece porque la LOA es un documento PDF y debe descargarse. Para descargarla, haz clic en Save Response (Guardar respuesta) en Postman y guarda el PDF en una ubicación conveniente.