Saltar a contenido

Creación de una VXC entre un Puerto y Microsoft Azure con la API

Este tema explica el procedimiento de la API para crear una VXC desde un Puerto a Microsoft Azure ExpressRoute, incluso cómo buscar ubicaciones de puertos de Azure y pedir las VXC.

La implementación del Puerto a Azure incluye estas tareas:

  1. Configure un circuito ExpressRoute en la consola de Azure.
    Una vez implementado, obtendrá una clave de servicio. La clave de servicio está vinculada a los puertos asignados en Azure. Al validar una clave de servicio, la respuesta muestra los puertos primario y secundario asignados en Azure. Puede utilizar la clave de servicio dos veces: una para la conexión con el primario y otra vez para crear una conexión con el puerto secundario.
    Para obtener más detalles, consulte el tema de Microsoft Inicio rápido: Creación y modificación de un circuito ExpressRoute.

  2. Con la clave de servicio, cree e implemente las VXC desde el Megaport Portal.
    Este paso utiliza la API – los otros pasos están fuera de Megaport en el entorno de Azure.

  3. Con una VXC implementada en su circuito, configure el emparejamiento en el portal de Azure.
    La información de emparejamiento se comparte entre los circuitos primario y secundario, así como la VLAN interna asignada al par.
    Para obtener más detalles, consulte el tema de Microsoft Creación y modificación del emparejamiento de un circuito ExpressRoute.

  4. Configurar el equipo de las instalaciones del cliente (CPE).

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

Validar la clave de servicio

Cuando se utiliza API para validar una clave de servicio de Azure, la respuesta incluye detalles de ExpressRoute de los puertos y pares asociados. Necesita los detalles del puerto para crear los VXC.

Para validar la clave de servicio en la colección Postman

  1. En Postman, expanda Cloud Connectivity (Conectividad en la nube) > Port (Puerto) > Azure en la navegación izquierda y seleccione GET Look Up Azure Service Key (GET Buscar clave de servicio de Azure).

  2. Añada la clave de servicio al punto de conexión.

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

    GET {baseUrl}/v2/secure/azure/{service_key}
    

Este es un ejemplo de respuesta para una nueva clave (sin VXC configuradas).

{
    "message": "Successful lookup",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": {
        "managed": false,
        "connectType": "AZURE",
        "resource_type": "csp_connection",
        "bandwidth": 200,
        "service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
        "vlan": 3289,
        "megaports": [
            {
                "portSpeed": 10000,
                "name": "Washington DC Primary",
                "state": "VA",
                "description": "Azure ExpressRoute at Equinix DC2/6",
                "productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
                "nServiceId": 32832,
                "companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
                "country": "USA",
                "vxc": null,
                "port": 14570,
                "companyName": "Azure ExpressRoute",
                "locationId": 67,
                "productId": 14570,
                "type": "primary",
                "companyId": 1475
            },
            {
                "portSpeed": 10000,
                "name": "Washington DC Secondary",
                "state": "VA",
                "description": "Azure ExpressRoute at Equinix DC2/6",
                "productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
                "nServiceId": 36431,
                "companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
                "country": "USA",
                "vxc": null,
                "port": 16108,
                "companyName": "Azure ExpressRoute",
                "locationId": 67,
                "productId": 16108,
                "type": "secondary",
                "companyId": 1475
            }
        ],
        "peers": []
    }
}

El valor megaports:vxc es nulo para ambos Puertos, lo que indica que están disponibles para las nuevas VXC.

Para obtener detalles sobre cada campo de respuesta, consulte Campos de respuesta de la clave de servicio de Azure.

Crear las VXC

Con los detalles de la clave de servicio, cree una VXC para el puerto primario y otra VXC para el puerto secundario.

Para crear las VXC

  1. Seleccione POST Create VXC to Azure (POST Crear VXC a Azure).

    Consejo

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

  2. Actualice el Body (cuerpo) de la solicitud con el productUid del Puerto, el nombre de la VXC, el productUid del puerto principal de Azure y la clave de servicio. La velocidad máxima (rateLimit) se define en el valor del ancho de banda de la respuesta de la clave de servicio. En este caso, 200.

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

    POST {baseUrl}/v2/networkdesign/buy
    
[
    {
        "productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID of your Megaport (A End)
        "associatedVxcs": [
            {
                "productName": "Primary Azure VXC",
                "rateLimit": 200,
                "aEnd": {
                    "vlan": 102
                },
                "bEnd": {
                    "productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008", //retrieved port UID from the Azure service key lookup
                    "partnerConfig" : {
                        "connectType": "AZURE",
                        "serviceKey": "3e2480b2-b4d5-424b-976a-7b0de65a1b62" //service key from lookup response
                    }
                }
            }
        ]
    }
]

Cuando haya configurado sus VXC primarias y secundarias a los puertos de Azure, otra búsqueda de clave de servicio mostrará las VXC asociadas a los puertos de Azure. Las VXC se identifican con un número de identificación (megaports:vxc).

{
    "message": "Successful lookup",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": {
        "managed": false,
        "connectType": "AZURE",
        "resource_type": "csp_connection",
        "bandwidth": 200,
        "service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
        "vlan": 3289,
        "megaports": [
            {
                "portSpeed": 10000,
                "name": "Washington DC Primary",
                "state": "VA",
                "description": "Azure ExpressRoute at Equinix DC2/6",
                "productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
                "nServiceId": 32832,
                "companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
                "country": "USA",
                "vxc": 60621,
                "port": 14570,
                "companyName": "Azure ExpressRoute",
                "locationId": 67,
                "productId": 14570,
                "type": "primary",
                "companyId": 1475
            },
            {
                "portSpeed": 10000,
                "name": "Washington DC Secondary",
                "state": "VA",
                "description": "Azure ExpressRoute at Equinix DC2/6",
                "productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
                "nServiceId": 36431,
                "companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
                "country": "USA",
                "vxc": 60622,
                "port": 16108,
                "companyName": "Azure ExpressRoute",
                "locationId": 67,
                "productId": 16108,
                "type": "secondary",
                "companyId": 1475
            }
        ],
        "peers": []
    }
}

Para completar la configuración, configure el emparejamiento en el portal de Azure y configure sus dispositivos CPE.


Última actualización: 2024-02-09