Creación de una VXC a AWS con la API
Este tema explica el procedimiento de la API para crear una VXC a AWS, incluso cómo buscar ubicaciones de interconexión en la nube, validar la conexión y pedir la VXC.
El ejemplo de este tema crea una conexión VIF alojada a AWS con una tasa de datos de 500 Mbps. Para seguir este ejemplo, utilice la URL del entorno de ensayo, que le permite configurar las conexiones, pero no implementa ni cobra los servicios.
Antes de comenzar, obtenga un token de acceso válido. Para obtener más detalles, consulte Creación de una clave de API.
Consejo
Para ver todas las opciones de las solicitudes utilizadas en este ejemplo, consulte https://dev.megaport.com.
Para buscar los detalles de la ubicación del proveedor de nube en la colección Postman
-
Despliegue la carpeta Locations (Ubicaciones) en la navegación izquierda y haga clic en GET Partner Ports (Buscar Puertos asociados).
-
Haga clic en Send (Enviar) para realizar una solicitud GET (Buscar) en el servidor de la API.
GET {baseUrl}/v2/dropdowns/partner/megaportsEsta solicitud devuelve todas las interfaces que tiene Megaport con los proveedores de servicios en la nube. Puede buscar haciendo clic en la lupa e introduciendo una ubicación, un 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 las VIF alojadas y “AWSHC” para las conexiones alojadas.
Puede filtrar los resultados por “connectType” y “vxcPermitted”.
GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=trueEste ejemplo utiliza un Puerto en Interxion DUB2 que acepta VXCs (‘
vxcPermitted: true’) y que 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
},
Para probar y validar el pedido
-
En Postman, expanda Cloud Connectivity (Conectividad en la nube) > Port (Puerto) > AWS Direct Connect en la navegación izquierda y seleccione POST Validate AWS (POST Validar AWS) - Hosted VIF (VIF alojada).
-
Actualice el cuerpo de la solicitud con el “productUid” del Puerto, el “productUid” del puerto de AWS y el ID de la cuenta de AWS.
También puede cambiar otros valores, como el nombre, el límite de velocidad, el ID de la VLAN, los valores de ASN, authKey y el direccionamiento IP. -
Haga clic en Send (Enviar) para publicar la solicitud.
POST {baseUrl}/v2/networkdesign/validate
[
{
"productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"associatedVxcs": [
{
"productName": "My Amazon Direct Connect",
"rateLimit": "500",
"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": "312345679135",
"authKey": "123456",
"prefixes": "10.0.1.0/24",
"customerIpAddress": null,
"amazonIpAddress": null
}
}
}
]
}
]
Una vez validado, podrá realizar el pedido de VXC.
Para pedir la VXC a AWS
-
Copie el cuerpo validado de POST Validate AWS (POST Validar AWS) - Hosted VIF (VIF alojada) y péguelo en el cuerpo de POST Buy AWS (Publicar Comprar AWS) - Hosted VIF (VIF alojada).
-
Haga clic en Send (Enviar) para publicar la solicitud.
POST {baseUrl}/v2/networkdesign/buy
Este es un ejemplo de una respuesta correcta.
{
"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": "312345679135",
"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 puerto y la VXC ya aparecen en el Megaport Portal.
Para este ejemplo, la VIF alojada en AWS aparecerá en la cuenta del portal de AWS bajo Direct Connect - Virtual Interfaces. El titular de la cuenta puede aceptar la Interfaz Virtual y conectarla a una gateway privada virtual o a una Gateway de AWS Direct Connect y luego a sus VPC.