Creación de un VXC a AWS con la API
Este tema describe el procedimiento de la API para crear un VXC desde un Port a AWS, incluido cómo consultar las ubicaciones de interconexión con la nube, validar la conexión y solicitar el VXC.
El ejemplo de este tema crea una conexión Hosted VIF a AWS con una velocidad de 500 Mbps. Para seguir este ejemplo, utiliza la URL del entorno de staging, que te permite configurar las conexiones pero no las despliega ni factura los servicios.
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.
Consejo
Para ver todas las opciones de las solicitudes utilizadas en este ejemplo, consulta https://dev.megaport.com.
Consultar los detalles de ubicación del puerto de AWS
Para crear un VXC a AWS, necesitas conocer los detalles del puerto de AWS. Utiliza la API para devolver las interfaces que Megaport tiene con los proveedores de servicios en la nube, a fin de identificar los detalles del puerto de AWS requeridos.
Para consultar los detalles de ubicación del puerto de AWS en la colección de Postman
-
Expande la carpeta Locations (Ubicaciones) en la navegación izquierda y haz clic en GET Partner Megaports (GET Megaports de socios).
-
Haz clic en Send (Enviar) para realizar una solicitud GET al servidor de la API.
GET {baseUrl}/v2/dropdowns/partner/megaportsEsta solicitud devuelve todas las interfaces que Megaport tiene con Proveedores de servicios en la nube. Puedes buscar haciendo clic en la lupa e introduciendo una ubicación, 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 Hosted VIFs y “AWSHC” para Hosted Connections.
Puedes filtrar los resultados por
connectTypeyvxcPermitted.GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=trueEste ejemplo usa un puerto en Interxion DUB2 que acepta VXCs (
“vxcPermitted”: true) y 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
},
Crear y desplegar un VXC
Con los detalles del puerto de AWS obtenidos de la API GET Partner Megaports, puedes validar y luego crear un VXC.
Para probar y validar el pedido
-
En Postman, expande Cloud Connectivity > Port > AWS Direct Connect en la navegación izquierda y selecciona POST Validate AWS - Hosted VIF (v3).
-
Actualiza el Body de la solicitud con el
productUiddel Port, elproductUiddel puerto de AWS y el ID de la cuenta de AWS.
También puedes cambiar valores adicionales, como el nombre, el límite de velocidad (rate limit), la duración del contrato (term), el ID de VLAN, los valores ASN, el authKey y la configuración de direcciones IP. -
Haz clic en Send (Enviar) para realizar una solicitud POST.
POST {baseUrl}/v3/networkdesign/validate
[
{
"productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"associatedVxcs": [
{
"productName": "My Amazon Direct Connect",
"rateLimit": "500",
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"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": "XXXXXXXXXXXX",
"authKey": "123456",
"prefixes": "10.0.1.0/24",
"customerIpAddress": null,
"amazonIpAddress": null
}
}
}
]
}
]
Cuando se valide, estarás listo para realizar el pedido del VXC.
Para crear un VXC
-
Copia el Body validado de POST Validate AWS - Hosted VIF (v3) y pégalo en el Body de POST Buy AWS - Hosted VIF (v3).
-
Haz clic en Send (Enviar) para enviar la solicitud.
POST {baseUrl}/v3/networkdesign/buy
Aquí tienes un ejemplo de una respuesta satisfactoria.
{
"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": "XXXXXXXXXXXX",
"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 Port y el VXC ahora aparecen en el Megaport Portal.
En este ejemplo, la Hosted VIF de AWS aparecerá en la cuenta del portal de AWS en Direct Connect - Virtual Interfaces. El titular de la cuenta puede aceptar la Virtual Interface y conectarla a un Virtual Private Gateway o a un Direct Connect Gateway y luego a sus VPCs.