Creación de una VXC a AWS con la API

Este tema explica el procedimiento de la API para crear una VXC a AWS, incluso cómo buscar ubicaciones de interconexión en la nube, validar la conexión y pedir la VXC.

El ejemplo de este tema crea una conexión VIF alojada a AWS con una tasa de datos de 500 Mbps. Para seguir este ejemplo, utilice la URL del entorno de ensayo, que le permite configurar las conexiones, pero no implementa ni cobra los servicios.

Consejo

Para ver todas las opciones de las solicitudes utilizadas en este ejemplo, consulte https://dev.megaport.com.

Para buscar los detalles de la ubicación del proveedor de nube en la colección Postman

  1. Despliegue la carpeta Locations (Ubicaciones) en la navegación izquierda y haga clic en GET Partner Ports (Buscar Puertos asociados).

  2. Haga clic en Send (Enviar) para realizar una solicitud GET (Buscar) en el servidor de la API.

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

    Esta solicitud devuelve todas las interfaces que tiene Megaport con los proveedores de servicios en la nube. Puede buscar haciendo clic en la lupa e introduciendo una ubicación, un centro de datos u otro parámetro en el campo de búsqueda.

    El connectType indica el proveedor de servicios en la nube. AWS incluye “AWS” para las VIF alojadas y “AWSHC” para las conexiones alojadas.

    Usted puede filtrar los resultados por connectType y vxcPermitted.

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

    Este ejemplo utiliza un Puerto en Interxion DUB2 que acepta VXCs (‘vxcPermitted: true’) y que está en la región eu-west-1.

      {
            "connectType": "AWS",
            "productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
            "vxcPermitted": true,
            "companyUid": "623cb950-abb4-4b07-b372-8cf55756c322",
            "companyName": "AWS",
            "title": "EU (Ireland) (eu-west-1)",
            "locationId": 96,
            "speed": 10000,
            "rank": 61,
            "lag_id": 2,
            "lag_primary": true,
            "aggregation_id": 54188
        },

Para probar y validar el pedido

  1. En Postman, expanda Cloud Connectivity (Conectividad en la nube) > AWS Direct Connect en la navegación izquierda y seleccione Validate AWS (Validar AWS).

  2. Actualice el cuerpo de la solicitud con el “productUid” del Puerto, el “productUid” del puerto de AWS y el ID de la cuenta de AWS.
    También puede cambiar otros valores, como el nombre, el límite de velocidad, el ID de la VLAN, los valores de ASN, authKey y el direccionamiento IP.

  3. Haga clic en Send (Enviar) para publicar la solicitud.

    POST {baseUrl}/v2/networkdesign/validate
    
[
    {
        "productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7", 
        "associatedVxcs": [
            {
                "productName": "My Amazon Direct Connect",
                "rateLimit": "500",
                "aEnd": {
                    "vlan": 777
                },
                "bEnd": {
                    "productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f", 
                    "partnerConfig": {
                        "connectType": "AWS",
                        "name": "Amazon name for service",
                        "type": "private",
                        "asn": 65105,
                        "amazonAsn": 64555,
                        "ownerAccount": "312345679135",
                        "authKey": "123456",
                        "prefixes": "10.0.1.0/24",
                        "customerIpAddress": null,
                        "amazonIpAddress": null
                    }
                }
            }
        ]
    }
]

Una vez validado, podrá realizar el pedido de VXC.

Para pedir la VXC a AWS

  1. Copie el cuerpo validado de POST Validate AWS (Publicar Validar AWS) y péguelo en el cuerpo de POST Buy AWS (Publicar Comprar AWS).

  2. Haga clic en Send (Enviar) para publicar la solicitud.

    POST {baseUrl}/v2/networkdesign/buy
    

Este es un ejemplo de una respuesta correcta.

{
    "message": "VXC [47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e] created. ",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
        {
            "createDate": 1588868593704,
            "vxcOrderId": 42328,
            "payerMegaPortId": 68124,
            "nonPayerMegaPortId": 52786,
            "payerMegaPortName": "API Port",
            "nonPayerMegaPortName": "EU (Ireland) (eu-west-1)",
            "payerCompanyId": 2278,
            "nonPayerCompanyId": 117,
            "payerLocationId": 89,
            "nonPayerLocationId": 96,
            "salesId": null,
            "payerCompanyName": "Megaport Lab",
            "nonPayerCompanyName": "AWS",
            "payerMegaPortNsId": 138231,
            "nonPayerMegaPortNsId": 221182,
            "payerVlanId": 777,
            "nonPayerVlanId": 0,
            "payerApproverName": "Paul McGuinness",
            "payerApproverId": 12695,
            "nonPayerApproverName": "Paul McGuinness",
            "nonPayerApproverId": 12684,
            "payerApproval": 1582268553574,
            "nonPayerApproval": 1228868693614,
            "fixedTerm": true,
            "duration": 1,
            "rollover": true,
            "serviceName": "from API Port to EU (Ireland) (eu-west-1)",
            "payerStatus": "APPROVED",
            "nonPayerStatus": "APPROVED",
            "speed": 500,
            "distanceBand": "ZONE",
            "intercapPath": "",
            "awsId": null,
            "promoCode": null,
            "rateType": "MONTHLY",
            "vxcJTechnicalServiceId": 57115,
            "vxcJTechnicalServiceUid": "47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e",
            "provisionDate": 1588868593517,
            "orderType": "NEW",
            "monthlyDiscountAmount": null,
            "discountMonths": null,
            "amazonDirectConnectConfigDto": {
                "type": "private",
                "asn": 65105,
                "ownerAccount": "312345679135",
                "authKey": "123456",
                "customerIpAddress": null,
                "amazonIpAddress": null,
                "prefixes": "10.0.1.0/24",
                "name": "Amazon name for service"
            },
            "amsixConnectConfigDto": null,
            "webAirProvItem": null,
            "sdrcProvItem": null,
            "rate": null,
            "setup": null,
            "asn": null,
            "bgpPassword": null,
            "usageAlgorithm": "POST_PAID_HOURLY_SPEED_LONG_HAUL_VXC",
            "costCentre": null,
            "azureServiceKey": null,
            "oracleVirtualCircuitId": null,
            "serviceKey": null,
            "connectType": "AWS",
            "payerConfig": {},
            "nonPayerConfig": {},
            "attributeTags": {},
            "fullyApproved": true
        }
    ]
}

El Puerto y la VXC ya aparecen en el Portal de Megaport.

Vista del Portal del Puerto de la API y la VXC

Para este ejemplo, la VIF alojada en AWS aparecerá en la cuenta del portal de AWS bajo Direct Connect - Virtual Interfaces. El titular de la cuenta puede aceptar la Interfaz Virtual y conectarla a una gateway privada virtual o a una Gateway de AWS Direct Connect y luego a sus VPC.


Última actualización: