> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://es.megaport.ferndocs.com/es/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://es.megaport.ferndocs.com/es/_mcp/server.

# Notas de la versión

## Nuevo punto final para datos de IPsec

**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)

## Visibilidad del Estado de Invitación de Empleado

**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 y Límites de Recursos de Socio

**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`.

Estructura de ejemplo:

**`JSON`**

```json JSON
{  
...  
"resourceLimits": [  
{  
"productType": "MEGAPORT",  
"limit": 10  
},  
{  
"productType": "VXC",  
"limit": 20  
}  
],  
...  
}
```

## Valores de Imágenes MVE y Velocidad de Servicio

**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.

**Valores de Velocidad de Servicio en GET /v3/locations** – Los valores de la matriz `mcrSpeedMps` y `megaportSpeedMbps` en la respuesta del punto final `/v3/locations` ahora se devuelven en orden ascendente.

## Actualizaciones de Locations API v3 e Invoice APIs

**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](/api-reference).

**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](/api-reference).

**Prohibir Eliminación de Servicio cuando Existen VXCs Conectados** – Anteriormente, eliminar un producto en el Proveedor de Terraform de Megaport, ya sea explícitamente o debido a cambios en la velocidad del Puerto, podría eliminar inadvertidamente los VXCs adjuntos. Esto causaba un problema ya que el Proveedor de Terraform de Megaport no era consciente de la eliminación, lo que provocaba resultados inesperados. Por lo tanto, se ha añadido un parámetro de consulta `safe_delete=true` a las llamadas de eliminación en el Proveedor de Terraform de Megaport, lo que indica a la API que devuelva un error al eliminar un producto si tiene VXCs adjuntos. Esto deja claro al usuario que necesita mover el VXC primero, o eliminarlo de forma independiente de su operación actual, sin causar problemas en el estado de Terraform. Esto no afecta a los usuarios actuales de API o Portal.

## Soporte de Tramas Jumbo y Filtrado de Paquetes

**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.

**Filtrado de Paquetes en Endpoints de MCR** – Se han creado nuevos endpoints para administrar filtros de paquetes MCR a través de la API. También se han agregado nuevos campos al punto de datos del endpoint de creación/actualización de VXC dentro del objeto de interfaces para definir filtros de paquetes para un VXC (`packetFilterIn`/`packetFilterOut`).

* `GET /v2/product/mcr2/{productUid}/packetFilter/{packetFilterId}` – Detalles de Filtro de Paquetes MCR
* `GET /v2/product/mcr2/{productUid}/packetFilters` – Lista de Resumen de Filtros de Paquetes MCR
* `POST /v2/product/mcr2/{productUid}/packetFilter` – Crear Filtro de Paquetes MCR
* `PUT /v2/product/mcr2/{productUid}/packetFilter/{packetFilterId}` – Actualizar Filtro de Paquetes MCR
* `DEL /v2/product/mcr2/{productUid}/packetFilter/{packetFilterId}` – Eliminar Filtro de Paquetes MCR

**Corregido** – El endpoint `/v2/products` tardaba hasta 4 minutos en responder para Google Inc. Ahora se ha reducido significativamente a alrededor de 50 segundos.

## Mejoras de GET /v3/locations

**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`).

## Preferencias de Notificación y Eliminación del Punto Final CXC

**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](/api-reference).

**Eliminado el Punto Final PUT /v2/product/cxc/\{productUid}** – El punto final `PUT /v2/product/cxc` ha sido descontinuado, ya que todos los servicios CXC activos han sido migrados a VXCs. Los usuarios deben acceder al punto final `PUT /v2/product/vxc/{productUid}` en su lugar.

## ID de Circuito Virtual de Oracle Ahora Devuelto

**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

**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.

## Desactivación de API v2 y Actualizaciones de Factura

**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}`

Para más información, consulte [Preguntas Frecuentes de Cierre de API v2](/api-reference).

**APIs de Facturas Actualizadas de v2 a v3** – Las API de facturas han sido actualizadas de v2 a v3, para admitir companyUid.

* `GET /v3/company/${companyUid}/invoice/supplierId/{supplierId}?fromDate=${fromDate}&toDate=${toDate}`
* `GET /v3/company/${companyUid}/invoice/${invoiceId}`
* `GET /v3/company/${companyUid}/invoice/${invoiceId}/pdf`
* `GET /v3/company/${companyUid}/invoice/${invoiceId}/csv`

**Etiquetas de Recursos Agregadas al Informe de Facturas** – Las etiquetas de recursos para servicios han sido agregadas al informe de Facturas (solo CSV). Esto permite exportar información de etiquetado para análisis externo.

**Zona de Diversidad Agregada a la Respuesta para CSPs** – Anteriormente, los clientes que querían conectarse a un CSP no podían ver la zona de diversidad a la que se estaban conectando al revisar los puertos disponibles. La información de la zona de diversidad ahora se ha agregado a la respuesta que se devuelve para que los clientes puedan determinar la zona de diversidad a la que se están conectando para un servicio determinado. Por ejemplo, la respuesta que se devuelve en esta solicitud ahora incluirá la zona de diversidad: `/v2/secure/google/{pairing_key}`.

## Configuración de Temporizadores MCR BFD Eliminada

**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 y Nuevos Puntos Finales de MVE

**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.

**Nuevos Puntos Finales para MVE** – Se han añadido los nuevos puntos finales `GET v3/locations` y `GET v4/product/mve/images`. v3/locations y v4/product/mve/images están destinados a reemplazar v2/locations y v3/product/mve/images. Los detalles de MVE se han trasladado a v4/product/mve/images. Si v3/locations diversityZones tiene un valor en mveMaxCpuCoreCount, puede solicitar cualquier MVE desde el punto final v4/product/mve/images siempre que el tamaño sea menor que maxMaxCpuCoreCount.

**Agregar Validación de Longitud Máxima al Campo de Referencia de Nivel de Servicio** – Se han cambiado las validaciones para el campo de Referencia de Nivel de Servicio (`costCentre`) de modo que este campo ahora tiene un valor máximo de 255 caracteres.

**Corregido** – La API respondía con un error 400 en lugar de un 404 al consultar un producto que no existe.

## Descarga de CSV de Telemetría y Mejoras de Rendimiento

**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](/api-reference).

**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.

## Monitoreo de Eventos de Mantenimiento e Interrupción

**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](/api-reference).

**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

**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 y Actualización de GSA/GRA

**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.

## Actualizaciones de la API de Inventario de Servicios y API de MVE

**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](/api-reference).

**API de Tamaños de MVE Disponibles Actualizada** – La API de Tamaños de MVE Disponibles GET `/v2/product/mve/variants` ha sido actualizada para eliminar el parámetro `bandwidthMbps` de la respuesta.

**Cambios en la API de validación/compra de MVE para Eliminar Proveedor** – Se han realizado cambios en las siguientes API de MVE para eliminar `vendor` como parámetro requerido. Este parámetro ya no es necesario y, si se pasa, simplemente se ignorará.

* `/v2/networkdesign/validate`
* `/v3/networkdesign/validate`
* `/v2/networkdesign/buy`
* `/v3/networkdesign/buy`

## Nuevas API de Facturas, Zonas de Diversidad y Cierre de VXC

**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](/api-reference) e [Facturas](/api-reference).

**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)](/api-reference) y el punto final de Comprar MVE (v3) para el proveedor relevante.

**Cierre de VXC agregado a la Pantalla de Creación** – La función de cierre de VXC e IX se ha expandido para que ahora pueda cerrar un servicio de VXC e IX al crear el servicio. Anteriormente, solo se podía hacer al editar el servicio. Ahora puede pasar el parámetro `shutdown` en los puntos finales de API de validación y compra v2/v3. Si no se pasa, el valor predeterminado es FALSO (Habilitado).

## Términos de VXC y API de Telemetría Mejorada

**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.

**API de Telemetría Mejorada** – Se han realizado las siguientes mejoras en las API de Telemetría:

* Ahora se puede especificar un intervalo de tiempo en 'días en el pasado' en lugar de necesitar fechas exactas.
* Se pueden solicitar múltiples métricas en una sola solicitud (por ejemplo, tasa de bits + tasa de paquetes) para reducir el número de solicitudes necesarias.

Para más información, consulte [Tipos de Métricas](/api-reference).

**Anchos de Banda Compatibles con AWS HC Fetch** – Se ha creado una nueva API pública `/v2/secure/awshc` para buscar puertos AWS HC con opciones de ancho de banda compatibles.

_Showing the 20 most recent of 25 entries. Append `/llms.txt` to the changelog URL for the complete index._