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:
- Your organization must be transitioned to Equinix Identity and Access Management.
- Your organization has billing accounts available that don't require a purchase order number to place an order.
- Equinix Fabric Manager role must be assigned to the account used to send API requests. For more information, see Assign and Unassign Roles to Users.
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.
-
Use the Get Projects endpoint to list all projects under your root organization.
-
Use the Get IBX Data Centers endpoint to list IBX data centers where Equinix Internet Access is available.
-
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
). -
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. -
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>