Connect Network Edge Device to Microsoft Azure

Establish a direct, layer 2 connection from a Network Edge Device to Microsoft Azure to access the Azure Cloud Infrastructure and other Azure Cloud services.

Step 1: Create ExpressRoute Circuit

In the Microsoft Azure portal, create an ExpressRoute circuit and retrieve its Service Key. The Service Key provides bandwidth and Peering Locatin for configuration in the Fabric portal.

Step 2: Create Connection

1. Authenticate

Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication.

2. Determine A-side NE device information
You need a provisioned Equinix Virtual Device/Redundant Devices/Cluster with a registered license. Check your available virtual devices and clusters by calling Get Virtual Devices or Get Virtual Device {uuid}. You may choose any available interface of the device for your connection. However, Equinix will select an interface if you do not specify any.

3. Choose Z-side metro location
Use the Get All Metros API request to find all metros where Equinix Fabric is available and determine destination location.

4. Identify service profile
Call Retrieve Service Profiles API to search for a specific service profile or use the Get Service Profiles API request to list all available service profiles, and identify the profile you want to connect to.

5. Validate your Authorization Key
Use the Validate Connection Authorization Key API request to verify that your Azure key can be used to create a connection to the selected service profile in the given metro.

6. Establish connection
Use the POST /fabric/v4/connections API request to create a connection with the pre-determined attributes.

Sample curl request - connection to Microsoft Azure ExpressRoute from a Network Edge Device

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
-d '{
    "type": "EVPL_VC",
    "name": "Conn-1",
    "order": {
        "purchaseOrderNumber": "1-129105284100"
    },
    "bandwidth": 1000,
    "aSide": {
        "accessPoint": {
        "type": "VD",
        "virtualDevice": {
        "type": "EDGE",
        "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXX"
        },
        "interface": {
            "type": "NETWORK",
            "id": 7
            }
        }
    },
    "zSide": {
        "accessPoint": {
            "type": "SP",
            "profile": {
                "type": "L2_PROFILE",
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
            },
            "location": {
                "metroCode": "SV"
            },
            "authenticationKey": "xx-xx-xx",
            "peeringType": "MICROSOFT"
        }
    },
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "test@equinix.com"
            ]
        }
    ]
}'

Body parameters

Sample response - connection to Microsoft Azure ExpressRoute from a NE device

{
    "type": "EVPL_VC",
    "href": "https://api.equinix.com/fabric/v4/connections/3da14bba-d81c-4497-93c3-3f4a3cb0bc40",
    "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "name": "vd2azure-vvv-0425a",
    "operation": {
        "providerStatus": "PROVISIONING",
        "equinixStatus": "PROVISIONING"
    },
    "order": {
        "purchaseOrderNumber": "1-1234567890",
        "billingTier": "Up to 200 MB"
    },
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "x@gmail.com"
            ]
        }
    ],
    "changeLog": {
        "createdBy": "fabricamcrh1",
        "createdByFullName": "XXXXXX XXXXXX",
        "createdByEmail": "x@gmail.com",
        "createdDateTime": "2024-04-25T20:30:24.632Z",
        "updatedBy": "fabricamcrh1",
        "updatedByFullName": "fabric amcrh1",
        "updatedByEmail": "x@gmail.com",
        "updatedDateTime": "2024-04-25T20:30:24.632Z"
    },
    "bandwidth": 100,
    "redundancy": {
        "group": "6b869af5-3f89-4329-bb41-ec6f6b053cc4",
        "priority": "PRIMARY"
    },
    "aSide": {
        "accessPoint": {
            "interface": {
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "id": 9,
                "type": "CLOUD"
            },
            "location": {
                "metroCode": "DC"
            },
            "virtualDevice": {
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "type": "EDGE"
            }
        }
    },
    "zSide": {
        "accessPoint": {
            "location": {
                "metroCode": "SV"
            },
            "profile": {
                "href": "https://api.equinix.com/fabric/v4/serviceProfiles/a1390b22-bbe0-4e93-ad37-85beef9d254d",
                "type": "L2_PROFILE",
                "name": "Azure ExpressRoute",
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
            },
            "authenticationKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        }
    }
}

Response description

Step 3: Set Up Microsoft Peering

Log in to the Microsoft Azure portal and configure BGP peering. Once peering configuration is synchronized, the connection status retrieved via the GET Connections{uuid} should change from “Pending-BGP-Peering” to “Provisioned”. Alternatively, you can synchronize peering settings using the Equinix Fabric portal or the Manage Connection API request.