Creación de un VXC entre un MCR y Microsoft Azure con la API
Este tema describe el procedimiento de la API para crear un VXC desde un MCR hacia Microsoft Azure ExpressRoute, incluyendo cómo consultar ubicaciones de interconexión de Azure y solicitar VXC.
La implementación del MCR hacia Azure incluye estas tareas:
-
Configure un circuito de ExpressRoute en la consola de Azure
Una vez implementado, obtiene 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 usar la clave una segunda vez y crear otra conexión al puerto no utilizado.
Para obtener más información, consulte el tema de ayuda de Microsoft Tutorial: Create and modify an ExpressRoute circuit.
-
Con la clave de servicio, cree y despliegue su VXC
Como parte de la configuración del VXC, puede elegir el tipo de peering.
El tipo de peering puede ser privado o Microsoft.
Un tipo de peering definido da como resultado un peering configurado automáticamente con peers emparejados tanto en el lado de Azure como en el de Megaport, y un sistema implementado con una configuración funcional conocida. Puede modificar la configuración una vez implementado.
Antes de comenzar, obtenga un token de acceso válido. Para más información, consulte Creación de una clave de API.
Validar la clave de servicio
Cuando usa la API para validar una clave de servicio de Azure, la respuesta incluye los detalles de ExpressRoute de los puertos y peers asociados. Necesita los detalles del puerto para crear los VXC.
Para validar la clave de servicio en la colección de Postman
-
En Postman, expanda Cloud Connectivity > MCR > Azure (Conectividad de la nube > MCR > Azure) en la navegación de la izquierda y seleccione GET Look Up Azure Service Key (GET Consultar clave de servicio de Azure).
-
Añada la clave de servicio al endpoint.
-
Haga clic en Send (Enviar) para realizar una solicitud GET al servidor de la API.
GET {baseUrl}/v2/secure/azure/{service_key}
Aquí hay una respuesta de ejemplo 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": []
}
}
Para obtener más información sobre cada campo de la respuesta, consulte Campos de respuesta de la clave de servicio de Azure.
Solicitar un VXC con opciones de peering
Con los detalles de la clave de servicio, cree un VXC hacia el puerto primario y otro VXC hacia el puerto secundario. Asegúrese de seleccionar un MCR en la misma región que los puertos de Azure devueltos por la consulta de la clave de servicio.
Si especifica el tipo de peering en la solicitud API para el VXC, Megaport configurará las direcciones IP y los detalles BGP tanto en el MCR como en el lado de Azure para garantizar una configuración BGP funcional.
Para especificar el tipo de peering, añada un tipo de peering al array peers en la sección partnerConfig. Si no existe un array peers, los peers se extraen de Azure. Si no se especifican peers al crear el VXC y no hay peers en Azure (lo normal para claves nuevas), el peering del MCR no se autoconfigurará.
El MCR crea una VLAN por cada tipo de peering configurado. Si se especifican tanto las opciones de peering privado como Microsoft, el MCR configurará dos VLAN internas.
Nota
Los tipos de peering se recuerdan y no se pueden cambiar si la clave ya se ha usado anteriormente.
Para crear el VXC
-
Cree una solicitud con el endpoint POST Create VXC to Azure (v3):
POST {baseUrl}/v3/networkdesign/buyConsejo
Para probar su solicitud antes de realizar el pedido, puede usar: POST {baseUrl}/v3/networkdesign/validate
-
Actualice el Body de la solicitud con el
productUiddel MCR, el nombre del VXC, elproductUiddel puerto de Azure y la clave de servicio. Incluya la opción de peering correspondiente. La velocidad máxima (rateLimit) viene definida en el valorbandwidthde la respuesta de la clave de servicio. En este caso, es 200.La VLAN de Azure (si se especifica) es la etiqueta externa VLAN para Q-in-Q. Si no especifica la VLAN, se aprovisionará automáticamente.
Para usar una clave de Azure con la opción de peering privado, use esta plantilla:
[
{
"productUid": "{{mcrid}}",
"associatedVxcs": [
{
"productName": "Azure Primary VXC",
"rateLimit": 200,
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 0
},
"bEnd": {
"productUid": "{{azurepuid}}",
"vlan": "{{azurevlan}}",
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "{{azurekey}}",
"peers": [{"type": "private"}]
}
}
}
]
}
]
Para peering Microsoft, use esta línea para los peers:
Para ambos peering, Microsoft y privado, use esta línea:
Después de crear un VXC para el puerto primario de Azure, cree otro VXC para conectar con el productUid del puerto secundario de Azure (cambie el productName y el bEnd: productUid).
Respuesta configurada
Cuando cree los VXC con peering, otra consulta de validación de la clave de servicio mostrará 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"
}
]
}
}