action.skip

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)

Escenario que muestra los puertos activos que posee el proveedor de servicios

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:

Escenario y flujo de trabajo: Un proceso paso a paso para conectarse a la plataforma de un proveedor de servicios: El cliente solicita una conexión a un on-ramp en la plataforma del proveedor de servicios. El proveedor de servicios enumera las regiones donde hay Ports disponibles: USA, UK, Japan, Australia. El cliente selecciona una región (USA). El proveedor de servicios enumera las ciudades con Ports activos en USA: Los Angeles, New York. El proveedor de servicios asigna los Ports disponibles en Los Angeles a una región llamada US-West, lo que permite a los clientes conectarse a uno de los Ports disponibles en US-West. El proveedor de servicios decide qué on-ramp ofrecer al cliente, considerando capacidad/uso y diversidad. El cliente selecciona US-West y añade diversidad. El proveedor de servicios crea claves de servicio para los Ports seleccionados: Los Angeles 1 (zona azul) Los Angeles 2 (zona roja) El cliente crea conexiones usando las claves de servicio.

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:

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.

  1. 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
    
  2. 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
  3. 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
  4. 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:

Proceso que muestra el flujo de trabajo de claves de servicio explicado 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).

Escenario que muestra que los ID de VLAN asignados por el proveedor de servicios pueden diferir de los ID de VLAN asignados por los clientes

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".
  • USA
  • UK
  • Japan
  • Australia
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".
  • Los Angeles
  • New York
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".
  • Equinix LA1 (“locationId”: 59)
  • CoreSite LA1 (“locationId”: 60)
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:
  • Los Angeles 1 (zona azul)
  • Los Angeles 2 (zona roja)
Clave de ejemplo:
“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.