Administración de la conectividad con las API de Megaport como proveedor de servicios
Los proveedores de servicios pueden integrar sin problemas la funcionalidad de Megaport en su plataforma. Pueden controlar el acceso de los clientes a sus on-ramps, como Ports.
Los proveedores de servicios pueden usar una clave de servicio para gestionar el acceso de los clientes y la conectividad segura a sus on-ramps. Pueden establecer límites de velocidad específicos y segmentar el tráfico de los clientes mediante VLAN.
Una clave de servicio es un código que un titular de cuenta de Megaport entrega a otro para conectar entre sí dos empresas independientes. Los clientes que tienen cuentas de Megaport separadas pueden conectar sus Ports, MCRs, o MVEs entre sí a través de la red de Megaport, habilitando VXCs de empresa a empresa.
Antes de permitir que sus clientes se conecten a un on-ramp mediante una clave de servicio, un proveedor de servicios debe conectarse primero a la red de Megaport. Una vez conectado, debe:
- decidir cuáles de sus conexiones deben usarse como on-ramps
- asociar esas ubicaciones de on-ramp a sus regiones o zonas definidas por el usuario
- considerar la capacidad y las zonas de diversidad para la gestión de la redundancia
Este tema describe cómo usted, como proveedor de servicios, puede usar las API de Megaport para reducir el esfuerzo manual y habilitar un aprovisionamiento más rápido de servicios. Esto facilitará vender conectividad privada a sus clientes.
Escenario
QuantumGPU es una pequeña empresa proveedora de servicios, con sede en Los Ángeles, California, que opera como una plataforma de autoservicio y bajo demanda de GPU-as-a-Service (GPUaaS). Al ofrecer a las empresas computación acelerada por GPU en diversas ubicaciones geográficas, QuantumGPU opera los siguientes Ports:
- 2 Ports en Los Ángeles, USA (Equinix LA1 y CoreSite LA1)
- 1 Port en Nueva York, Estados Unidos (Telehouse)
- 1 Port en Londres, Reino Unido (Telehouse North)
- 1 Port en Osaka, Japón (Equinix OS1)
- 1 Port en Sídney, Australia (Global Switch Sydney West)

QuantumGPU necesita controlar cómo sus clientes se conectan a los Ports y automatizar el proceso con las API.
QuantumGPU (proveedor de servicios) planea implementar el siguiente escenario:

Términos relacionados
Asegúrese de estar familiarizado con la siguiente terminología utilizada en este tema:
Megaport Cloud Router (MCR)
El MCR es un servicio de router virtual administrado que establece conectividad de Capa 3 en la red definida por software (SDN) mundial de Megaport. Las instancias de MCR están preconfiguradas en centros de datos en zonas de enrutamiento globales clave. Un MCR habilita la transferencia de datos entre redes multicloud o de nube híbrida, proveedores de servicios de red y proveedores de servicios cloud.
Megaport Virtual Edge (MVE)
MVE es una plataforma de Virtualización de Funciones de Red (NFV) bajo demanda y neutral respecto al proveedor que proporciona infraestructura virtual para servicios de red en el borde de la red global definida por software (SDN) de Megaport. Las tecnologías de red como SD-WAN y NGFW se alojan directamente en la red global de Megaport a través de Megaport Virtual Edge.
On-ramp
Un on-ramp es una conexión directa y privada a los recursos disponibles de un proveedor de servicios, por ejemplo, a través de una conexión de Megaport. Para garantizar conexiones rápidas y confiables, el proveedor de servicios asigna estos recursos a sus regiones o zonas, establece límites de tasa, gestiona la capacidad de VLAN por cliente, etc.
Port
Un Port es la interfaz Ethernet de alta velocidad que se conecta a la red global definida por software (SDN) de Megaport. Los Ports están disponibles en 1 Gbps, 10 Gbps, 100 Gbps u opciones de mayor velocidad, según la ubicación y la disponibilidad del servicio.
Port diversity
La diversidad de Port mejora la robustez de su red al proporcionar servicios de Port en diferentes dispositivos físicos en una única ubicación de Megaport. Los Ports se asignan a zonas de diversidad. Una zona de diversidad agrupa dispositivos en la misma ubicación para garantizar que los servicios se aprovisionen en dispositivos físicamente separados que siempre permanezcan diversos.
Service key
Una clave de servicio es un código que un titular de cuenta de Megaport entrega a otro para conectar entre sí dos empresas independientes. Los clientes que tienen cuentas de Megaport separadas pueden conectar sus Ports, MCRs, o MVEs entre sí a través de la red de Megaport, habilitando VXCs de empresa a empresa.
Virtual Cross Connect (VXC)
Un VXC es un circuito Ethernet de Capa 2 directo que proporciona conexiones privadas, flexibles y bajo demanda entre cualquiera de las ubicaciones de la red de Megaport, ofreciendo capacidades que van desde 1 Mbps hasta velocidades de múltiples Gbps de alta capacidad, con niveles superiores disponibles en regiones seleccionadas.
Autenticación como usuario de API
Antes de poder usar las API de Megaport, debe autenticarse con un token de acceso. Antes de poder generar el token de acceso, debe crear una clave de API en el Megaport Portal. Para obtener más información, consulte Creación de una clave de API.
La clave de API consta de un ID de cliente y un secreto de cliente. Puede usarla para generar el token de acceso que se utiliza para autenticarse como usuario de API.
Los tokens de acceso son válidos durante 24 horas y deben regenerarse después de ese período. Su integración con la API de Megaport deberá tener esto en cuenta. Para obtener más información, consulte Generar un token de acceso.
Administración de on-ramps
Cuando su cliente solicite una conexión hacia usted, tendrá que asociar la región o zona de la conexión a un on-ramp físico para generar la clave de servicio.
Esta sección describe las llamadas de API para asociar la región o zona de servicio de sus usuarios a su on-ramp de Megaport. Los identificadores de ubicaciones y productos de Megaport son constantes, por lo que esto puede almacenarse en caché o guardarse de forma segura sin necesidad de actualizarlo cada vez.
Estas instrucciones describen cómo hacerlo con Postman y la colección de API de Megaport. Para obtener más información sobre la configuración de Postman, consulte Descripción general de la API de Megaport.
Requisitos previos
Esta sección presupone que:
- ha integrado Megaport en su plataforma. Para obtener más información, consulte Integrar Megaport en su plataforma.
- está autenticado como usuario de API. Para obtener más información, consulte Autenticación como usuario de API.
Listar ubicaciones de on-ramp
Esta tarea describe cómo puede buscar y enumerar sus ubicaciones de on-ramp disponibles (ubicaciones de Port en nuestro escenario) usando los identificadores de ubicación.
Para listar ubicaciones de on-ramp
Nota
Este ejemplo utiliza Ports, pero también puede usar MCRs y MVEs.
-
Después de que su cliente solicite conectarse a un on-ramp, por ejemplo, a un Port, use la Get Product List API (API Obtener lista de productos) con
"provisioningStatus": "LIVE"para buscar todos los Ports activos que posee.GET /v2/products?provisioningStatus=LIVE -
Filtre y enumere la respuesta usando el valor country.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"En nuestro escenario, la lista es la siguiente:
- USA
- UK
- Japan
- Australia
-
Después de que su cliente seleccione una región (USA), filtre y enumere la respuesta usando el valor metro.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"En nuestro escenario, la lista es la siguiente:
- Los Angeles
- New York
-
Después de que su cliente seleccione una región (US-West), filtre y enumere la respuesta usando el valor locationId.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"En nuestro escenario, la lista es la siguiente:
- “locationId”: 59
- “locationId”: 60
Asignar una ubicación de on-ramp a una región o zona definida por el usuario
Puede usar los identificadores de ubicación listados, como locationId, metro o country y asignarlos a sus nombres de región o zona personalizados predefinidos.
Al asignar los on-ramps disponibles, como Los Angeles 1 (“locationId”: 59) y Los Angeles 2 (“locationId”: 60), a la región predefinida US-West, sus clientes pueden seleccionar US-West en su plataforma y conectarse a un on-ramp disponible.
Seleccionar un on-ramp
Puede usar API para identificar a qué on-ramp conectarse; por ejemplo, conectarse al Port con menor uso. Puede considerar factores como el número de conexiones, la capacidad o la utilización. Además, puede considerar factores como las zonas de diversidad para gestionar la redundancia.
Use la respuesta de los Ports filtrados para evaluar los atributos del Port como sigue:
| Atributo | Considere |
|---|---|
| diversityZone | Verifique si la ubicación actual admite diversidad. Para obtener más información, consulte Diversidad de Port. |
| portSpeed | Verifique la velocidad disponible del Port. |
| rateLimit | El límite de velocidad de VXC no puede exceder la velocidad del Port de menor velocidad. Para obtener más información, consulte Descripción general de conexiones. |
| associatedVxcs | Verifique si hay VXCs asociados al Port y la capacidad asignada. |
| maxVxcSpeed | Verifique la velocidad máxima de VXC disponible para el Port. |
| vxcPermitted | Asegúrese de que vxcPermitted sea true. Si el valor de vxcPermitted es false, no puede crear un VXC hacia ese Port. |
Tras evaluar los Ports seleccionados, puede mostrar un Port que cumpla los criterios requeridos; por ejemplo, un Port con el menor uso. Para obtener más información, consulte Descripción general de la API de Megaport.
Administración de conexiones
Siguiendo las prácticas recomendadas para gestionar las claves de servicio e ID de VLAN, puede mantener conexiones organizadas y seguras.
Administración de claves de servicio
Las claves de servicio permiten que sus clientes establezcan conexiones a sus on-ramps específicos.
Administrar claves de servicio implica crear, compartir y supervisar las claves de servicio.
Este proceso se muestra y explica con más detalle a continuación:

Después de seleccionar el servicio de on-ramp, puede crear una clave de servicio para el on-ramp. Crear la clave de servicio no tiene costo adicional para usted, independientemente de que su cliente use la clave o no.
Comparta la clave de servicio con su cliente. Opcionalmente, cree un flujo de trabajo para su cliente que describa los pasos necesarios y un plazo indicativo para usar la clave de servicio recibida.
Como requisito previo, su cliente debe tener una cuenta con Megaport y disponer de un Port disponible.
Con la clave de servicio, su cliente puede crear un VXC y conectarse al on-ramp según los parámetros que usted especificó. Su cliente es responsable de los cargos de VXC asociados con la ubicación de on-ramp seleccionada.
Use la GET List Service Keys (API Lista de claves de servicio) para supervisar continuamente y hacer seguimiento del estado de sus claves de servicio. Por ejemplo, verifique si se ha usado una clave de servicio que usted creó y envió a un cliente. Después de que su cliente usa la clave de servicio, esta queda obsoleta y el ID de la clave de servicio no se conserva. Esto significa que no hay conexión entre la clave de servicio y el servicio que activó.
La clave de servicio es específica para un servicio. Para garantizar la redundancia y la resiliencia ante fallas o interrupciones, recomendamos crear on-ramps ubicados en diferentes zonas de diversidad. En este caso, también debe crear claves de servicio separadas para cada on-ramp; por ejemplo:
- 1 clave para Los Angeles 1 en la zona de diversidad azul
- 1 clave para Los Angeles 2 en la zona de diversidad roja
Puede crear una clave de servicio de un solo uso o de uso múltiple. Con una clave de un solo uso, el cliente con quien comparte la clave puede solicitar una única conexión a un on-ramp específico. Con una clave de uso múltiple, el cliente con quien comparte la clave puede solicitar múltiples conexiones. En tales casos, el sistema asigna automáticamente el siguiente ID de VLAN disponible.
Administración de ID de VLAN
Para las claves de servicio de un solo uso, especifique un ID de VLAN, que puede usar para vincular a los clientes con sus respectivos VXCs. Cuando asigna un ID de VLAN a la clave de servicio, indica que el VXC asignado está dedicado a un cliente específico. Cada VXC se entrega como una VLAN separada en su on-ramp. Este debe ser un ID de VLAN único en este on-ramp y puede ir de 2 a 4093.
La siguiente imagen muestra que asignó diferentes ID de VLAN para cada cliente, de la siguiente manera:
- VLAN ID 100 asignado al Cliente 1
- VLAN ID 200 asignado al Cliente 2
Los ID de VLAN (100 y 200) que usted asigna pueden diferir de los ID de VLAN asignados por sus clientes (123 y 10), o de los ID de VLAN asignados a otras conexiones de Port que tengan, como las de proveedores de servicios cloud como AWS, Oracle o Azure (124, 125 y 20).

Para obtener más información, consulte Configuración de claves de servicio y Creación de una clave de servicio con la API.
Resumen
Este tema describió cómo puede gestionar eficientemente las conexiones de los clientes a sus on-ramps.
Usando las API de Megaport para buscar Ports, seleccionar Ports según capacidad, diversidad, etc., puede automatizar el proceso, reducir el esfuerzo manual y habilitar un aprovisionamiento rápido de servicios.
Resumen de las API utilizadas
Esta tabla muestra el proceso y las API utilizadas en este escenario:
Nota
Este ejemplo usa Ports, pero el mismo proceso se usa para MCRs y MVEs.
| Acción del cliente del proveedor de servicios | Acción del proveedor de servicios | Solicitudes de API y valores usados para filtrar | Resultado |
|---|---|---|---|
| En la plataforma del proveedor de servicios, solicite una conexión a un on-ramp. | Liste las regiones con Ports activos, MCRs o MVEs. | GET /v2/products? provisioningStatus=LIVE Enumere los valores de "country". |
|
| Seleccione una región (USA). | Liste las ciudades con Ports activos, MCRs o MVEs en USA. | GET /v2/products? provisioningStatus=LIVE &country=USA Enumere los valores de “metro". |
|
| Liste los Ports en Los Angeles. Asigne los Ports disponibles, por ejemplo, Los Angeles 1 (“locationId”: 59) y Los Angeles 2 (“locationId”: 60), a una región llamada US-West. Luego, en su plataforma, sus clientes pueden conectarse a uno de los Ports disponibles en US-West. Decida qué on-ramp ofrecer al cliente. Considere la capacidad/uso y la diversidad. |
GET /v2/products? provisioningStatus=LIVE &country=USA&metro=Los Angeles Enumere los valores de "locationId". |
|
|
| Seleccione US-West y añada diversidad. | Cree claves de servicio para los Ports seleccionados. Envíe las claves de servicio de vuelta a su cliente. |
POST /v2/service/key Valor requerido: "productUid" |
Se crean 2 claves separadas para:
“key”: “106e38ae-eb59-415f-ac81-526a5299851d”, |
| Cree conexiones con las claves de servicio. |
Integrar Megaport en su plataforma
Para ver un ejemplo de cómo integrar Megaport en su plataforma, consulte el proyecto de demostración en https://github.com/megaport/megaportgo.