Creación de un VXC entre un Port y Microsoft Azure con la API
Este tema describe el procedimiento de la API para crear un VXC desde un Port hacia Microsoft Azure ExpressRoute, incluyendo cómo consultar las ubicaciones de puertos de Azure y solicitar los VXC.
La implementación de Port a Azure incluye estas tareas:
-
Configurar un circuito de ExpressRoute en la consola de Azure
Al implementar, obtienes una clave de servicio. La clave de servicio está vinculada a los puertos asignados en Azure. Cuando validas una clave de servicio, la respuesta muestra los puertos primario y secundario asignados en Azure. Puedes usar la clave de servicio dos veces - una vez para conectarte al primario y una segunda vez para crear otra conexión al puerto secundario.
Para obtener más información, consulta el tema de ayuda de Microsoft Tutorial: Create and modify an ExpressRoute circuit. -
Con la clave de servicio, crea e implementa tus VXC desde el Megaport Portal
Este paso utiliza la API – los otros pasos están fuera de Megaport en el entorno de Azure.
-
Con un VXC implementado en tu circuito, configura Peering en el portal de Azure
La información de Peering se comparte entre los circuitos primario y secundario, al igual que la VLAN interna asignada al par.
Para obtener más información, consulta el tema de ayuda de Microsoft Create and modify peering for an ExpressRoute circuit. -
Configurar el equipo en las instalaciones del cliente (CPE)
Antes de comenzar, obtén un token de acceso válido. Para obtener más información, consulta Creación de una clave de API.
Validar la clave de servicio
Cuando usas la API para validar una clave de servicio de Azure, la respuesta incluye los detalles de ExpressRoute de los puertos y pares asociados. Necesitas los detalles del puerto para crear los VXC.
Para validar la clave de servicio en la colección de Postman
-
En Postman, expande Cloud Connectivity > Port > Azure (Conectividad a la nube > Port > Azure) en la navegación izquierda y selecciona GET Look Up Azure Service Key (GET Consultar clave de servicio de Azure).
-
Añade la clave de servicio al endpoint.
-
Haz clic en Send (Enviar) para realizar una solicitud GET al servidor de la API.
GET {baseUrl}/v2/secure/azure/{service_key}
Aquí tienes un ejemplo de respuesta para una clave nueva (sin VXC configurados):
{
"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 null para ambos Ports, lo que indica que están disponibles para nuevos VXCs.
Para más información sobre cada campo de la respuesta, consulta Campos de respuesta de la clave de servicio de Azure.
Crear e implementar los VXCs
Con los detalles de la clave de servicio, crea un VXC hacia el puerto primario y otro VXC hacia el puerto secundario.
Para crear los VXCs
-
Selecciona POST Create VXC to Azure (v3).
Consejo
Para probar tu solicitud antes de ordenar y ver detalles de precios, puedes usar: POST {baseUrl}/v3/networkdesign/validate
-
Actualiza el Body de la solicitud con el
productUiddel Port, el nombre del VXC, elproductUiddel puerto primario de Azure y la clave de servicio. La velocidad máxima (rateLimit) se define en el valor de ancho de banda de la respuesta de la clave de servicio. En este caso, es 200. -
Haz clic en Send (Enviar) para enviar la solicitud.
POST {baseUrl}/v3/networkdesign/buy
[
{
"productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID of your Megaport (A-End)
"associatedVxcs": [
{
"productName": "Primary Azure VXC",
"rateLimit": 200,
"term":12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"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 hayas configurado tus VXCs primario y secundario hacia los puertos de Azure, otra consulta de la clave de servicio mostrará los VXCs asociados a los puertos de Azure. Los VXCs se identifican por un número de ID (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 peering en el portal de Azure y configura tus dispositivos CPE.