Notas de la versión

Nuevo punto final para datos de IPsec – Se ha creado un nuevo punto final GET /v3/products/mcrs/{productUid}/ipsec para recuperar datos relacionados con IPsec. El cuerpo de respuesta del punto final incluye lo siguiente:

• Límite máximo de recuento de túneles IPsec para el MCR.
• Recuento total de túneles - número total de túneles configurados para un MCR.
• La lista de túneles IPsec configurados con detalles, incluyendo:
  • Nombre de VXC
  • UID de producto de VXC
  • VLAN
  • Túneles IPsec (direcciónIpOrigen, direcciónIpDestino, descripción)

Campo invitationPending agregado a /v2/employee – Se agregó el campo invitationPending a la respuesta del endpoint GET /v2/employee para mejorar la visibilidad del estado de invitación de empleado.

Pedido de Conexión Cruzada – En los endpoints networkdesign/validate y networkdesign/buy, la implementación de Conexión Cruzada ha sido actualizada para usar la configuración addOn en lugar de la bandera crossConnectRequested.

Límites de Recursos de Socio – Los socios de Megaport ahora pueden configurar límites de recursos para sus empresas administradas a través de la API. Los endpoints POST y PUT /v2/managedCompanies ahora aceptan un nuevo campo opcional en el Cuerpo de la solicitud llamado resourceLimits.

Cambios para GET /v4/product/mve/images – Estos cambios se han realizado en el Cuerpo de respuesta de este punto final:

• Se ha añadido un nuevo campo vendorProductId. Este es un identificador único generado concatenando los valores product y vendor.
• Las imágenes MVE ahora se devuelven con las más recientes (id más alto) primero, por producto y proveedor.

GET /v3/locations – El Portal de Megaport se ha actualizado para usar el nuevo punto de conexión de API /v3/locations en lugar de /v2/locations. El API pública /v2/locations ahora está obsoleta y se dará de baja completamente el 31 de julio de 2025. Para obtener más información, consulte Avisos de Deprecación de API y Preguntas Frecuentes.

Invoice APIs Actualizadas a V3 – El Portal de Megaport se ha actualizado para usar los nuevos puntos de conexión de API de facturas v3 en lugar de v2. Tenga en cuenta también que companyId se ha actualizado a companyUid, y se ha añadido supplierId a la URL en la versión v3. Las API públicas v2 ahora están obsoletas y se darán de baja completamente el 31 de julio de 2025. Para obtener más información, consulte Avisos de Deprecación de API y Preguntas Frecuentes.

Soporte de Tramas Jumbo en MCR – Se ha agregado un nuevo campo ipMtu a los siguientes endpoints que permite establecer el tamaño más grande (en bytes) de un paquete IP que se puede enviar a través del VXC conectado.

• POST /v3/networkdesign/validate
• POST /v3/networkdesign/buy
• PUT /v3/product/vxc/{uid}

Mejoras del Endpoint de Facturación – Los endpoints de facturación se han actualizado para cambiar los campos de Fecha de Cargo de Factura Desde/Hasta para reflejar el período de tiempo al que se aplica el ETF - la duración del ETF.

GET /v3/locations actualizado – Se han realizado las siguientes mejoras en el punto final /v3/locations:

• Se agregó el parámetro opcional mveImageId. Al incluir el mveImageId, el punto final devolverá solo las ubicaciones que tienen capacidad para el mveImageId. Si no se pasa el mveImageId, el valor de mveMaxCpuCoreCount siempre será nulo.
• Se agregó el campo de velocidad de MCR (mcrSpeedMbps).

Nuevo Punto Final /v3/notificationPreferences – Se ha agregado el punto final /v3/notificationPreferences para permitir a los usuarios suscribirse a notificaciones individuales o grupos de notificaciones en el Portal de Megaport. Este punto final reemplaza el anterior punto final /v2/notificationPreferences. Para obtener más información, consulte Notificaciones por Correo Electrónico.

ID de Circuito Virtual de Oracle Ahora Devuelto – Se han realizado mejoras en las API públicas relacionadas con Oracle VXCs. El campo virtualCircuitId (el ID de VLAN en el lado de Oracle del VXC) ahora se devuelve en la respuesta de estas API:

• GET /v2/product/{uid}
• GET /v2/products
• POST /v3/networkdesign/validate
• POST /v3/networkdesign/buy

Registro de Actividad – Se han realizado mejoras en la información de actividad de la cuenta que se registra y muestra en el Portal de Megaport. También se ha creado una nueva API v3/activity que se puede utilizar para recuperar registros de actividad del usuario que ha iniciado sesión.

Desactivar APIs v2 Reemplazadas por APIs v3 – Como se comunicó anteriormente, algunas de nuestras API v2 han sido reemplazadas por versiones v3 y estaban programadas para su desactivación. Estas API v2 ahora han sido oficialmente desactivadas y ya no son compatibles con Megaport:

• Obtener Precio de MVE: GET /v2/pricebook/mve
• Obtener Precio de VXC: GET /v2/pricebook/vxc
• Validar Pedidos: POST /v2/networkdesign/validate
• Comprar Servicios: POST /v2/networkdesign/buy
• Actualizar Detalles de VXC: PUT /v2/product/vxc/{productUid}
• Eliminar Servicios: POST /v2/product/{productUid}/action/{action}

Configuración de Temporizadores MCR BFD Eliminada – La compatibilidad para mantener la configuración de temporizadores MCR BFD ha sido eliminada de la API. Los ajustes de BFD no son editables, los valores predeterminados configurados cuando BFD está habilitado son Intervalo de Transmisión: 300 milisegundos, Intervalo de Recepción: 300 milisegundos, Multiplicador: 3.

Etiquetado de Recursos – Ahora los clientes tienen la capacidad de crear, modificar y eliminar etiquetas de recursos para administrar sus servicios activos a través de la API de Megaport. Las etiquetas de recursos son pares de clave y valor que actúan como metadatos para organizar recursos de Megaport. Estas etiquetas aparecerán de forma predeterminada en el informe de Inventario de Servicios para la empresa que haya implementado las etiquetas, siempre que posea el servicio en el que se coloca la etiqueta.

Descarga de CSV de Telemetría – Las API de telemetría de servicio ahora pueden descargar datos de utilización en formato CSV, además del formato de texto. Para obtener más información, consulte Tipos de Métricas.

Mejoras de Velocidad de GET /v2/product/{productUid} – Se ha optimizado el rendimiento de esta API. En algunos casos, el tiempo de carga de esta API para empresas más grandes se ha reducido a la mitad.

Soporte para Monitoreo de Eventos de Mantenimiento e Interrupción – Las API públicas /ens/v1/status/outage y /ens/v1/status/maintenance han sido creadas para permitirle monitorear actividades de mantenimiento e interrupciones de servicio. Para más información, consulte Eventos de Mantenimiento e Interrupción.

Corregido – Se estaban produciendo errores NPE en el endpoint /v2/employment porque el usuario no tenía una dirección de correo electrónico definida.

Megaport Internet Disponible en Más Países – Las conexiones de Megaport Internet ahora también pueden ser solicitadas desde Puertos y MCR en Nueva Zelanda, Canadá y Singapur, además de Australia, Reino Unido y Estados Unidos donde ya estaban disponibles.

Nueva API /v3/login – Se ha creado una nueva API /v3/login para reemplazar la próxima API /v2/login que quedará obsoleta. La API v2 ya no será compatible; por favor, migre todas las integraciones de API que tenga desde la versión v2 a la nueva versión de API v3.

GSA/GRA Actualizado – Megaport ha actualizado los términos estándar del Acuerdo de Servicios Globales (GSA) y del Acuerdo de Revendedor Global (GRA) (de conformidad con las Cláusulas 15(a) y 20(a) respectivamente). Como parte de esta actualización, la tarifa de terminación anticipada (ETF) aplicada a un servicio en un contrato que se cancela antes de completar su término ha cambiado del 50% al 100%. Este cambio entró en vigor en el Portal de Megaport el 15 de abril de 2024.

Nueva API de Inventario de Servicios – Se ha creado una nueva API pública /v2/secure/inventory/companies/{companyUid}/services/csv que le permite descargar su inventario de servicios, incluidos los servicios históricos, en formato de archivo de valores separados por comas (CSV). También puede devolver el inventario de servicios en formato JSON utilizando la API /v2/secure/inventory/companies/{companyUid}/services. Para obtener más información, consulte Informe de Inventario de Servicios.

Nuevas API de Facturas – Para garantizar que siga recibiendo los datos de factura más precisos, actualizados y completos, incluidas las notas de crédito y la información fiscal, es necesario migrar a los nuevos puntos finales de la API de facturas. Para obtener más información, consulte Preguntas frecuentes sobre Nuevas API de Facturas e Facturas.

Diversidad de MCR y MVE – Ahora puede elegir una zona de diversidad al crear MCR y MVE. Puede pasar el parámetro diversityZone al validar y ordenar un MCR y MVE a través de la API. Para obtener más información, consulte Comprar MCR (v3) y el punto final de Comprar MVE (v3) para el proveedor relevante.

Términos de VXC – Ahora los VXCs pueden ser contratados por 12, 24 o 36 meses. Las siguientes API han sido actualizadas para aceptar el nuevo campo opcional term para establecer un término en un VXC:

• POST /v3/networkdesign/validate
• POST /v3/networkdesign/buy
• PUT /v3/product/vxc/{productUid}

Los valores aceptables para term son: 1, 12, 24, 36. Si no se proporciona term al validar y ordenar un VXC, se establece por defecto en 1 (Sin Término Mínimo). Si no se proporciona term al actualizar un VXC, el valor existente no se actualiza.