Order Internet Access with Dedicated Port
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 can be used for:
-
Primary Internet Access – for customers that want to use Equinix Internet Access as their main internet connection.
-
Backup Internet Access – for customers that use a different internet provider as the primary internet access and want Equinix Internet Access to be the backup solution in case their main internet connection goes down.
-
Management Access – for customers that need an independent, out-of-band channel for managing their servers and network devices collocated in Equinix IBX data centers.
Use the Get Default Settings for Equinix Internet Access with Dedicated Port API to request to retrieve default, recommended configuration settings.
Prerequisites
- 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.
1.Use the Get IBX Data Centers endpoint to list IBX data centers where Equinix Internet Access is available.
In addition to IBX data centers returned by this API, Equinix Internet Access with Dedicated Port is also available for offline ordering in select Equinix facilities in Bulgaria, China, Poland, and Turkey. To order Equinix Internet Access service in one of those countries, contact your Equinix sales representative.
-
Get eligible 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.
-
Get Colocation Cages Information. Use the Get Cages endpoint to retrieve your cages in a given IBX data center and associated with the specified billing account.
-
Get Cabinets Information. Use the Get Cabinets endpoint to retrieve your cabinets in a given cage.
-
Get Patch Panel Details. Use the Get Patch Panels API request to retrieve patch panels in the specified cabinet and determine which ports are available.
Creating the Service Instance
To create an Internet Access service instance, send a POST request to the /internetAccess/v1/services endpoint. Specify the service details in the body of the request.
Sample cURL Request:
curl -X POST 'https://api.equinix.com/internetAccess/v1/services'
-H 'content-type: application/json'
-H 'authorization: Bearer <$TOKEN>'
-d '{
"name": "Web servers",
"description": "Internet connection for Minecraft server.",
"type": "DUAL_PORT",
"useCase": "MAIN",
"billing": "FIXED",
"bandwidth": 500,
"connections": [
{
"type": "IA_C",
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"bandwidth": 1000,
"type": "IA_PORT",
"location": {
"ibx": "DC5"
},
"lag": {
"enabled": false
},
"connectivitySource": {
"type": "COLO"
},
"physicalPorts": [
{
"type": "XF_PHYSICAL_PORT",
"speed": 1000,
"demarcationPoint": {
"mediaType": "Single-Mode Fiber",
"connectionService": "Single-Mode Fiber",
"connectorType": "SC",
"cageSpaceId": "DC5:01:20221219_910222",
"cabinetSpaceId": "DC5:01:20221219_910222:Demarc",
"patchPanel": "CP:Demarc:1266844",
"patchPanelPortA": 1,
"patchPanelPortB": 2
}
}
]
}
}
}
},
{
"type": "IA_C",
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"bandwidth": 1000,
"type": "IA_PORT",
"location": {
"ibx": "DC5"
},
"lag": {
"enabled": false
},
"connectivitySource": {
"type": "COLO"
},
"physicalPorts": [
{
"type": "XF_PHYSICAL_PORT",
"speed": 1000,
"demarcationPoint": {
"mediaType": "Single-Mode Fiber",
"connectionService": "Single-Mode Fiber",
"connectorType": "SC",
"cageSpaceId": "DC5:01:20221219_910222",
"cabinetSpaceId": "DC5:01:20221219_910222:Demarc",
"patchPanel": "CP:Demarc:1266844",
"patchPanelPortA": 3,
"patchPanelPortB": 4
}
}
]
}
}
}
}
],
"routingProtocols": [
{
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": 30
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": 64
}
}
]
}
}
],
"order": {
"referenceNumber": "",
"signature": {
"signatory": "DELEGATE",
"delegate": {
"email": "someone.else@equinix.com"
}
},
"contacts": [
{
"type": "TECHNICAL",
"registeredUser": "amer-click-po-user"
},
{
"type": "NOTIFICATION",
"registeredUser": "amer-click-po-user"
}
]
},
"account": {
"accountNumber": "123456"
}
}'
Sample Response:
{
"uuid": "e6b8874f-d1f8-4f94-ad57-96569dd74486",
"type": "DUAL_PORT",
"useCase": "MAIN",
"name": "Web servers",
"description": "Internet connection for web servers."
"bandwidth": 500,
"account": {
"accountNumber": "123456"
},
"billing": "FIXED",
"draft": false,
"order": {
"href": "https://api.equinix.com/internetAccess/v1/services/e6b8874f-d1f8-4f94-ad57-96569dd74486/orders/4b8df286-5562-41e2-8753-0379eecbe176",
"uuid": "4b8df286-5562-41e2-8753-0379eecbe176",
"type": "AMENDMENT"
},
"state": "PENDING"
}
Monitoring Your Request
Use the Get Internet Access Order Details endpoint to monitor your Equinix Internet Access order.
curl -X GET 'https://api.equinix.com/internetAccess/v1/orders/4b8df286-5562-41e2-8753-0379eecbe176'
-H 'authorization: Bearer <$TOKEN>'