action.skip
Documentación de Megaport
Creación de una VXC de MCR con la API
PDF

Creación de una VXC de MCR con la API

Este tema explica el procedimiento de API para crear una VXC de MCR. El primer ejemplo crea una conexión alojada en AWS en el mercado estadounidense - una de las configuraciones más complicadas. Las plantillas para otros proveedores aparecen más adelante en este mismo tema.

Creación de una VXC entre un MCR y AWS con conexión alojada

Este ejemplo crea una conexión alojada en AWS en el mercado estadounidense. Los pasos incluyen lo siguiente:

  • obtener el ID del producto MCR
  • encontrar el ID de ubicación de un mercado estadounidense disponible
  • validar y pedir la VXC
  • configurar dos rutas estáticas
  • configurar conexiones BGPProtocolo de gateway de borde.
    Un protocolo de enrutamiento estandarizado diseñado para intercambiar información de ruta y accesibilidad entre sistemas autónomos (AS) en Internet.     – una conexión con detalles de MEDDiscriminador de salida múltiple.
    Un atributo de la ruta BGP que puede influir en un vecino BGP para tomar una ruta preferida cuando el sistema autónomo (AS) anunciante es el mismo para las rutas candidatas y hay varios puntos de entrada para ese AS.     y BFDDetección de reenvío bidireccional.
    El protocolo BFD detecta cualquier fallo en la ruta entre vecinos BGP directamente conectados, lo que permite un tiempo de reconvergencia del enrutamiento BGP más rápido.     y otra sin ellos

Antes de comenzar, obtenga un token de acceso válido. Para obtener más detalles, consulte Creación de una clave de API.

Para crear la VXC, necesitamos el productUid del MCR.

Para obtener el productUid del MCR

  1. Obtenga la lista de productos. 

    GET {baseUrl}/v2/products/

  2. En los detalles del producto, localice el valor productUid del MCR que desee conectar.

    Este ejemplo utiliza este valor: fee85cc0-f06f-4ad7-bce7-36aef7dbe0d0

A continuación, busque la ID de ubicación del mercado estadounidense que desee y que admita conexiones alojadas de AWS.

Para encontrar el locationId en el mercado estadounidense en el que están disponibles las conexiones alojadas de AWS

  1. Obtenga la lista de todas las interfaces que tiene Megaport con los proveedores de servicios en la nube. 

    GET {baseUrl}/v2/dropdowns/partner/megaports

    Puede filtrar los resultados por connectType y vxcPermitted.

    GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWSHC&vxcPermitted=true

  2. Haga clic en la lupa y busque en la respuesta un sitio que coincida con sus criterios de ubicación.

    Para este ejemplo, seleccione “US West (Oregon) (us-west-2) [DZ-RED]” con “locationId”: 57.

{
            "connectType": "AWSHC",
            "productUid": "f274bd09-1796-43af-8837-28fa4fa2a1ab",
            "vxcPermitted": true,
            "companyUid": "605cb850-dfb4-4a05-a171-8bf17757b3a2",
            "companyName": "AWS",
            "title": "US West (Oregon) (us-west-2) [DZ-RED]",
            "locationId": 57,
            "speed": 10000,
            "rank": 275,
            "lag_id": 5,
            "lag_primary": true,
            "aggregation_id": 106462
        },

Nota

[DZ-RED] significa zona de diversidad roja. Cada sitio de conexión alojada de AWS ofrece dos zonas de diversidad para proporcionar redundancia: DZ-Red y DZ-Blue.

Con el ID de MCR y el ID de ubicación de AWS, puede pedir una VXC.

Para pedir la VXC

  1. Cree una solicitud con esta URL: 

    POST {baseUrl}/v2/networkdesign/buy

    Consejo

    Para probar su solicitud antes de hacer el pedido, puede utilizar: POST {API Server URL}/v2/networkdesign/validate

  2. Añada estos encabezados a la solicitud:

    • Content-Type: application/json
    • Autorización: Portador {su token de acceso}

  3. Cree el cuerpo de la solicitud con los detalles de la configuración.

    Este ejemplo utiliza la id. del producto MCR, la ID de la ubicación de AWS para el extremo B, crea dos rutas estáticas y configura las conexiones BGP, una conexión con detalles MED y BFD y otra sin ellos. Las siguientes secciones proporcionan detalles sobre las rutas estáticas y las conexiones BGP. 

[
  {
    "productUid": "fee85cc0-f06f-4ad7-bce7-36aef7dbe0d0",
    "associatedVxcs": [
      {
        "rateLimit": 100,
        "productName": "awshc",
        "aEnd": {
          "locationId": 320,
          "vlan": 0,
          "partnerConfig": {
            "connectType": "VROUTER",
            "interfaces": [
              {
                "ipAddresses": [
                  "10.191.0.25/29"
                ],
                "bfd": {
                  "txInterval": 300,
                  "rxInterval": 300,
                  "multiplier": 3
                },
                "bgpConnections": [
                  {
                    "peerAsn": 62512,
                    "localIpAddress": "10.191.0.25",
                    "peerIpAddress": "10.191.0.26",
                    "password": "cnn6eaeaETSjvjvjvjv",
                    "shutdown": false,
                    "description": "BGP with MED and BFD enabled",
                    "medIn": 100,
                    "medOut": 100,
                    "bfdEnabled": true
                  },
                  {
                    "peerAsn": 62511,
                    "localIpAddress": "10.191.0.27",
                    "peerIpAddress": "10.191.0.28",
                    "password": "cnn23049asdkfj",
                    "shutdown": false,
                    "description": "BGP without MED or BFD",
                    "medIn": null,
                    "medOut": null,
                    "bfdEnabled": false
                  }
                ],
                "ipRoutes": [
                  {
                    "prefix": "10.0.0.0/24",
                    "nextHop": "10.191.0.26",
                    "description": "test static route 1"
                  },
                  {
                    "prefix": "10.0.1.9/24",
                    "nextHop": "10.191.0.27",
                    "description": "test static route 2"
                  }
                ],
                "natIpAddresses": []
              }
            ]
          }
        },
        "bEnd": {
          "locationId": 57,
          "ownerUid": "605cb850-dfb4-4a05-a171-8bf17757b3a2",
          "productUid": "d5518ee1-e915-4e3d-a4e1-a2c7e04f2fdd",
          "vlan": 0,
          "partnerConfig": {
            "name": "awshc",
            "ownerAccount": "684021030471",
            "connectType": "AWSHC"
          }
        },
        "productType": "VXC",
        "connectType": "AWSHC"
      }
    ]
  }
]

Rutas estáticas

Se pueden crear varias rutas estáticas por interfaz añadiendo un rango ipRoutes al rango de interfaces del objeto de configuración del proveedor Extremo A:

"ipRoutes": [
  {
    "prefix": "10.0.0.0/24",
    "nextHop": "10.191.0.26",
    "description": "test static route 1"
  },
  {
    "prefix": "10.0.1.9/24",
    "nextHop": "10.191.0.27",
    "description": "test static route 2"
 }
],
Un rango de ipRoutes vacío indica que no hay rutas estáticas.

Atributo Descripción Requerido Entrada Válida
prefix Prefijo IP (V4 y V6) para enrutar a nextHop Sí Prefijo IP v4/v6 - Si no se presenta ninguna máscara, la dirección se trata como una dirección de host (/32)
nextHop Dirección del siguiente salto Sí Dirección IP v4/v6 - Debe estar en la misma subred que la interfaz, pero no la IP de la interfaz
description Descripción opcional de la ruta estática No Cadena - Longitud máxima, 100 caracteres

Conexiones BGP

Se pueden crear varias conexiones BGP por interfaz añadiendo un rango bgpConnections al rango de interfaces del objeto de configuración del proveedor Extremo A:

"bgpConnections": [
  {
    "peerAsn": 62512,
    "localIpAddress": "10.191.0.25",
    "peerIpAddress": "10.191.0.26",
    "password": "cnn6eaeaETSjvjvjvjv",
    "shutdown": false,
    "description": "BGP with MED and BFD enabled",
    "medIn": 100,
    "medOut": 100,
    "bfdEnabled": true
  },
  {
    "peerAsn": 62511,
    "localIpAddress": "10.191.0.27",
    "peerIpAddress": "10.191.0.28",
    "password": "cnn23049asdkfj",
    "shutdown": false,
    "description": "BGP without MED or BFD",
    "asPathPrependCount": "3",
    "bfdEnabled": false
  }
],
Atributo Descripción Requerido Entrada Válida
peerAsn El ASN del par BGP remoto Sí ASN válido - Números enteros entre 1 - 4294967294
localAsn El ASN local puede anular el ASN del MCR para este par BGP. En la mayoría de los casos debería dejarse el valor por defecto. No ASN válido - Números enteros entre 1 - 4294967294

No puede establecerse localAsn si peerAsn == mcrAsn

localAsn no puede coincidir con peerAsn si peerAsn != mcrAsn
localIpAddress La dirección IPv4 o IPv6 de esta interfaz que se utiliza para la comunicación con el par BGP. Sí Dirección IP v4/v6 válida. Debe ser una dirección IP de la interfaz
peerIpAddress La dirección IP del par BGP. Sí Dirección IP v4/v6 válida
password Una clave compartida que se utiliza para autenticar el par BGP, hasta 32 caracteres. No 0-32 caracteres
shutdown De forma predeterminada, las conexiones BGP están habilitadas y tratarán activamente de conectarse al par. Opte shutdown para deshabilitar temporalmente la sesión BGP sin quitarla. Esto puede ser útil para solucionar problemas o probar escenarios de conmutación por error. No true/false - Por defecto, false
description Descripción opcional de la conexión BGP No 0-100 caracteres
medIn El MED se aplicará a todas las rutas recibidas en esta conexión BGP. Déjelo en blanco para utilizar el valor recibido del par BGP. Se preferirá la ruta con el valor más bajo. No Compatible con valores entre 0 y 4.294.967.295
medOut El MED se aplicará a todas las rutas transmitidas en esta conexión BGP. Es posible que el sistema autónomo vecino prefiera el valor más bajo según su criterio. No Compatible con valores entre 0 y 4.294.967.295
asPathPrependCount asPathPrependCount es un número entero que representa el número de veces que el número de AS local se antepondrá a los anuncios de BGP salientes al par. No Los valores aceptables son del 1 al 10
bfdEnabled La detección de reenvío bidireccional permite la identificación rápida de fallos en esta conexión BGP. Cuando se interrumpe la conectividad, la sesión BGP se revoca sin esperar a que expire el temporizador de suspensión BGP. BFD puede mejorar el tiempo de conmutación por error cuando hay varias rutas disponibles. No true/false -
Por defecto, false
Opcional

Configuración de la detección de reenvío bidireccional (BFD)

El objeto de configuración bfd se aplica a todas las conexiones BGP de la interfaz que tengan bfdEnabled = true. Si alguna conexión BGP tiene bfdEnabled, el objeto bfd es necesario; de lo contrario, es opcional.

Nota

Esta configuración se utilizará para todas las conexiones BGP de la VXC con el BFD habilitado.

Se añade un objeto bfd a cada interfaz.

"bfd": {
  "txInterval": 300,
  "rxInterval": 300,
  "multiplier": 3
},
Atributo Descripción Requerido Entrada Válida
txInterval El tiempo mínimo entre envíos de paquetes BFD al vecino. El rango admitido es de 300 ms a 9000 ms. Sí 300-9000
rxInterval El tiempo mínimo entre paquetes BFD que envía un vecino. El rango admitido es de 300 ms a 9000 ms. Sí 300-9000
multiplier La sesión BGP no se revocará si no se reciben del vecino tantos paquetes BFD consecutivos. Sí 3-50

Autoconfiguración con AWS, Azure y Google

Para Azure, VIF alojada en AWS y Google, Megaport configurará el direccionamiento IP y los detalles de BGP tanto en MCR como en un proveedor para garantizar una configuración BGP que funcione. Esto también minimiza la cantidad de cambios entre los portales del CSP y Megaport.

Aunque el portal se encarga de la autoconfiguración por defecto, también puede utilizar la API para activar la autoconfiguración de BGP. La funcionalidad se activa cuando la clave de las interfaces en partnerConfig no existe o es nula.

Para configurar el emparejamiento BGP para los proveedores

  1. Cree una solicitud con esta URL: 

    POST {baseUrl}/v2/networkdesign/buy

  2. Añada estos encabezados a la solicitud:

    • Content-Type: application/json
    • Autorización: Portador {su token de acceso}

  3. Cree el cuerpo de la solicitud con los detalles de la configuración.

    Aquí están disponibles diferentes plantillas para los proveedores más populares.

VIF alojada en AWS

{
"productUid": "{{mcrid}}",
"associatedVxcs": [
 {
   "productName": "Test AWS VIF VXC",
   "rateLimit": 100,
   "aEnd": {
     "vlan": 0
   },
   "bEnd": {
     "productUid": "{{awsPortUid}}",
     "partnerConfig": {
       "connectType": "AWS",
       "type": "private",
       "ownerAccount": "{{yourAWSAccountNumber}}"
     }
   }
 }
]
}

Google Cloud

{
   "productUid": "{{mcrid}}",
   "associatedVxcs": [
    {
     "productName": "Test Google VXC",
     "rateLimit": 100,
     "aEnd": {
       "vlan": 0
     },
     "bEnd": {
       "productUid": "{{googlePortUid}}",
       "partnerConfig": {
         "connectType": "GOOGLE",
         "pairingKey": "{{googlekey}}"
       }
     },
     "productType": "VXC"
    }
   ]
}

Microsoft Azure

Para conocer los detalles de configuración de Azure, consulte Creación de una VXC entre un MCR y Microsoft Azure con la API.