Creación de una VXC entre un MCR y Microsoft Azure con la API
Este tema explica el procedimiento de la API para crear una VXC desde un MCR a Microsoft Azure ExpressRoute, incluso cómo buscar ubicaciones de interconexión de Azure y pedir VXCs.
La implementación de MCR a Azure incluye estas tareas:
-
Configure un circuito ExpressRoute en la consola de Azure.
Una vez implementado, obtendrá una clave de servicio. Al validar una clave de servicio, se le presentan los puertos primario y secundario y puede elegir el puerto para la conexión. Puede utilizar la clave una segunda vez y crear otra conexión con el Puerto no utilizado.
Para obtener más detalles, consulte el tema de Microsoft Inicio rápido: Creación y modificación de un circuito ExpressRoute.
-
Con la clave de servicio, cree e implemente una VXC.
Como parte de la configuración de una VXC, se puede elegir el tipo de emparejamiento.
El tipo de emparejamiento puede ser privado o de Microsoft.
Un tipo de emparejamiento definido da lugar a un emparejamiento configurado automáticamente con pares coincidentes tanto en Azure como en Megaport y un sistema implementado con una configuración de trabajo conocida. Puede modificar la configuración tras la implementación.
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.
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": []
}
}
Para obtener detalles sobre cada campo de respuesta, consulte Campos de respuesta de la clave de servicio de Azure.
Pedir una VXC con opciones de emparejamiento
Con los detalles de la clave de servicio, cree una VXC para el puerto primario y otra VXC para el puerto secundario. Asegúrese de que selecciona un MCR en la misma región que los puertos de Azure de la solicitud de búsqueda de claves de servicio.
Si especifica el tipo de emparejamiento en la solicitud de API para VXC, Megaport configurará el direccionamiento IP y los detalles de BGP tanto en MCR como en Azure para garantizar una configuración BGP que funcione.
Para especificar el tipo de emparejamiento, añada un tipo de emparejamiento al array de pares en la sección partnerConfig. Si no existe un array de pares, los pares se recuperan de Azure. Si no se especifican los pares al crear el VXC y no hay pares en Azure (lo que suele ocurrir con las nuevas claves de servicio), el emparejamiento de MCR no se configurará automáticamente.
El MCR crea una VLAN para cada tipo de emparejamiento configurado. Si se especifican las opciones de emparejamiento privado y de Microsoft, el MCR configura dos VLAN internas.
Nota
Los tipos de emparejamiento se recuerdan y no se pueden cambiar si se ha utilizado una clave previamente.
Para pedir la VXC
POST {baseUrl}/v2/networkdesign/buy
Consejo
Para probar su solicitud antes de hacer el pedido, puede utilizar: POST {baseUrl}/v2/networkdesign/validate
Actualice el Body (cuerpo) de la solicitud con el productUid del MCR, el nombre de la VXC, el productUid del puerto de Azure y la clave de servicio. Incluya la opción de emparejamiento adecuada. 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.
El VLAN de Azure (si se especifica) es el VLAN de etiqueta externa para Q-in-Q. Si no se especifica el VLAN, se autoaprovisiona.
Para utilizar una clave de Azure con opción de emparejamiento privado, utilice esta plantilla:
[
{
"productUid": "{{mcrid}}",
"associatedVxcs": [
{
"productName": "Azure Primary VXC",
"rateLimit": 200,
"aEnd": {
"vlan": 0
},
"bEnd": {
"productUid": "{{azurepuid}}",
"vlan": "{{azurevlan}}",
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "{{azurekey}}",
"peers": [{"type": "private"}]
}
}
}
]
}
]
Para el emparejamiento de Microsoft, utilice esta línea para los pares:
Para el emparejamiento de Microsoft y el privado, utilice esta línea:
Después de crear un VXC para el puerto de Azure primario, cree otro VXC para conectarse al productUid del puerto de Azure secundario (cambie el productName y el bEnd: productUid).
Respuesta configurada
Cuando se crean los VXC con emparejamiento, otra solicitud de validación de clave de servicio muestra la configuración completa.
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": true,
"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": 60574,
"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": 60575,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": [
{
"peer_asn": 133937,
"shared_key": null,
"primary_subnet": "169.254.167.176/30",
"secondary_subnet": "169.254.167.180/30",
"vlan": 100,
"type": "private"
},
{
"peer_asn": 133937,
"shared_key": null,
"prefixes": "117.18.81.116/30,117.18.81.120/30",
"primary_subnet": "117.18.81.116/30",
"secondary_subnet": "117.18.81.120/30",
"vlan": 200,
"type": "microsoft"
}
]
}
}