Skip to main content

device-link-price

Determine costs of a Device Link Connection.

For information on device linking, see Device Link Groups.

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. Send a GET request to the fabric/v4/metros endpoint to find all metros where Equinix Fabric is available and determine the device link location.

To get the pricing information for a Device Link Group, send a POST request to the /fabric/v4/prices/search endpoint. Specify your pricing criteria in the body of the request.

POST /fabric/v4/prices/search
MethodPOST
URL or Endpoint/fabric/v4/prices/search
HeadersAuthorization, Content-Type
Path ParametersNot applicable
Query ParametersNot applicable
Body Parametersfilter

Sample cURL Request:

curl -X POST 'https://api.equinix.com/fabric/v4/prices/search'  
curl -X POST 'https://api.equinix.com/fabric/v4/prices/search'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "filter": {
        "and": [
            {
                "property": "/type",
                "operator": "=",
                "values": [
                    "VIRTUAL_CONNECTION_PRODUCT"
                ]
            },
            {
                "property": "/connection/type",
                "operator": "=",
                "values": [
                    "VD_CHAIN_VC"
                ]
            },
            {
                "property": "/connection/bandwidth",
                "operator": "IN",
                "values": [
                    50,
                    1000
                ]
            },
            {
                "property": "/connection/aSide/accessPoint/type",
                "operator": "=",
                "values": [
                    "VD"
                ]
            },
            {
                "property": "/connection/aSide/accessPoint/location/metroCode",
                "operator": "=",
                "values": [
                    "CH"
                ]
            },
            {
                "property": "/connection/zSide/accessPoint/type",
                "operator": "=",
                "values": [
                    "CHAINGROUP"
                ]
            },
            {
                "property": "/connection/zSide/accessPoint/bridge/package/code",
                "operator": "=",
                "values": [
                    "GLOBAL"
                ]
            }
        ]
    }
}'

The parameters included in the request body are specific to this example. For a full list of parameters and their descriptions, see the API Reference.

Sample Response:

{  
"data": [
    {
        "type": "VIRTUAL_CONNECTION_PRODUCT",
        "code": "ECX00015.PROD",
        "name": "Equinix Fabric Virtual Connection Product",
        "description": "Equinix Fabric Virtual Connection",
        "charges": [
            {
                "type": "MONTHLY_RECURRING",
                "price": 500.0
            }
        ],
        "currency": "USD",
        "connection": {
            "type": "VD_CHAIN_VC",
            "bandwidth": 1000,
            "aSide": {
                "accessPoint": {
                    "type": "VD",
                    "location": {
                        "metroCode": "CH"
                    }
                }
            },
            "zSide": {
                "accessPoint": {
                    "type": "CHAINGROUP",
                    "bridge": {
                        "package": {
                            "code": "GLOBAL"
                        }
                    }
                }
            }
        }
    },
    {
        "type": "VIRTUAL_CONNECTION_PRODUCT",
        "code": "ECX00015.PROD",
        "name": "Equinix Fabric Virtual Connection Product",
        "description": "Equinix Fabric Virtual Connection",
        "charges": [
            {
                "type": "MONTHLY_RECURRING",
                "price": 200.0
            }
        ],
        "currency": "USD",
        "connection": {
            "type": "VD_CHAIN_VC",
            "bandwidth": 50,
            "aSide": {
                "accessPoint": {
                    "type": "VD",
                    "location": {
                        "metroCode": "CH"
                    }
                }
            },
            "zSide": {
                "accessPoint": {
                    "type": "CHAINGROUP",
                    "bridge": {
                        "package": {
                            "code": "GLOBAL"
                        }
                    }
                }
            }
        }
    }
],
"pagination": {
    "offset": 0,
    "limit": 2,
    "total": 2
}
}

Response payload includes configuration parameters defined in the request body. For a full list of possible parameters and their descriptions, see the API Reference.