Skip to main content

Order Internet Access with Fabric

Equinix Internet Access (EIA) provides blended internet access using multiple tier-1 Internet Service Providers (ISPs) and Equinix Internet Exchanges (IX) to deliver high availability reliability, and speed.

Equinix Internet Access with Fabric is available to organizations onboarded to Equinix Identity and Access Management. If your organization hasn't been onboarded to Equinix Identity and Access Management, you can order Equinix Internet Access with Dedicated Port.

Currently, Equinix Internet Access with Fabric supports only MAIN use case and FIXED billing type.

To place an order for Equinix Internet Access with Fabric:

Prerequisites

  1. Authenticate - Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication. Refer to API Authentication for instructions on how to call the OAuth API to validate and authenticate your credentials.

  2. Use the Get Projects endpoint to list all projects under your root organization.

  3. Use the Get IBX Data Centers endpoint to list IBX data centers where Equinix Internet Access is available.

  4. List available billing accounts. Use the List Accounts endpoint to get the list of billing accounts available to you for ordering Equinix Internet Access in the given IBX data center and assigned to a specified project. Internet Access with Fabric can be ordered using billing accounts that don't require a purchase order (billing.poBearing: false).

  5. Use the Get Ports endpoint to retrieve your Fabric ports information.

    Note that the port you use to order an Equinix Internet Access service must have sufficient available bandwidth remaining. For available bandwidth, check the availableBandwidth value in the payload returned by the request above.

  6. Use the Validate Connection endpoint to make sure the VLAN identifier you want to use is available.

Creating the Service Instance

To create a Internet Access service instance with Fabric, send a POST request to the /internetAccess/v1/services endpoint. Specify the service details in the body of the request.

Sample cURL Request - primary internet connection, single port, static routing, fixed billing:

curl -X POST 'https://api.equinix.com/internetAccess/v1/services'  
-H 'content-type: application/json'
-H 'authorization: Bearer <$token>
-d '{
    "name": "EIA_Direct",
    "type": "SINGLE_PORT",
    "useCase": "MAIN",
    "billing": "FIXED",
    "bandwidth": 10,
    "connections": [
        {
            "type": "IA_VC",
            "name": "EIA_Direct",
            "aSide": {
                "accessPoint": {
                    "type": "COLO",
                    "port": {
                        "type": "XF_PORT",
                        "uuid": "asdf5dbe-fa39-a399-f7e0-306a5c00af26"
                    },
                    "linkProtocol": {
                        "type": "DOT1Q",
                        "vlanTag": 1234
                    }
                }
            }
        }
    ],
    "routingProtocols": [
        {
            "type": "DIRECT",
            "ipv4": {
                "customerRoutes": [
                    {
                        "ipBlock": {
                            "prefixLength": 29
                        }
                    }
                ]
            },
            "ipv6": {
                "customerRoutes": [
                    {
                        "ipBlock": {
                            "prefixLength": 48
                        }
                    }
                ]
            }
        }
    ],
    "order": {
        "referenceNumber": ""
    },
    "account": {
        "accountNumber": "007"
    },
    "project": {
        "projectId": "6548320d-866b-4fdf-9b05-dcbe95f43bb1"
    }
}'

Sample curl request - primary internet connection, single port, direct routing, fixed billing

curl -X POST 'https://api.equinix.com/internetAccess/v1/services'  
-H 'content-type: application/json'
-H 'authorization: Bearer <$token>
-d '{
    "name": "EIA_Direct",
    "type": "SINGLE_PORT",
    "useCase": "MAIN",
    "billing": "FIXED",
    "bandwidth": 10,
    "connections": [
        {
            "type": "IA_VC",
            "name": "EIA_Direct",
            "aSide": {
                "accessPoint": {
                    "type": "COLO",
                    "port": {
                        "type": "XF_PORT",
                        "uuid": "asdf5dbe-fa39-a399-f7e0-306a5c00af26"
                    },
                    "linkProtocol": {
                        "type": "DOT1Q",
                        "vlanTag": 1234
                    }
                }
            }
        }
    ],
    "routingProtocols": [
        {
            "type": "DIRECT",
            "ipv4": {
                "customerRoutes": [
                    {
                        "ipBlock": {
                            "prefixLength": 29
                        }
                    }
                ]
            },
            "ipv6": {
                "customerRoutes": [
                    {
                        "ipBlock": {
                            "prefixLength": 48
                        }
                    }
                ]
            }
        }
    ],
    "order": {
        "referenceNumber": ""
    },
    "account": {
        "accountNumber": "007"
    },
    "project": {
        "projectId": "6548320d-866b-4fdf-9b05-dcbe95f43bb1"
    }
}'

The parameters included in the request bodies are specific to these examples. For a full list of parameters and their descriptions, see the API Reference.

Monitoring Your Request

To view the details of your Internet Access service instance, use the Get Specified Equinix Internet Access Service Instance endpoint.

curl -X GET 'https://api.equinix.com/internetAccess/v1/services/{id}'  
-H 'authorization: Bearer <$token>