Determine IP Block Price

Determine costs of an IP block in a specified location.

 

IP block is an Equinix-allocated set of public IP addresses that can be used for on-premises resource configuration, firewall configuration or NAT to cloud service providers (CSP).

Step 1: Authenticate

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

 

Refer to Generating Client ID and Client Secret under the Getting Access Token section for instructions on how to create client ID and client secret and refer to Requesting Access and Refresh tokens section for instructions on how to call Oauth API to validate and authenticate your credentials.

 

If you are unaware of your user credentials for Equinix Fabric, contact your local Equinix Service Desk.

Step 2: Get Attribute Information

Use the Get All Metros API request to find all metros where Equinix Fabric is available and determine connection origin location.

Step 3: Retrieve Pricing Information

Use the POST /fabric/v4/prices/search API request to retrieve IP block price estimates using pre-determined values.

	POST /fabric/v4/prices/search
Method	POST
URL or Endpoint	/fabric/v4/prices/search
Headers	Authorization, Content-Type
Path Parameters	Not applicable
Query Parameters	Not applicable
Body Parameters	filter

Sample curl request - pricing information for an IP block

curl -X POST 'http://api.equinix.com/fabric/v4/prices/search'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
-d '{
    "filter": {
        "and": [
 
            {
                "property": "/type",
                "operator": "=",
                "values": [
                    "IP_BLOCK_PRODUCT"
                ]
            },
            {
                "property": "/ipBlock/type",
                "operator": "=",
                "values": [
                    "IPv4"
                ]
            },
            {
                "property": "/ipBlock/prefixLength",
                "operator": "=",
                "values": [
                    29
                ]
            },
            {
                "property": "/ipBlock/location/metroCode",
                "operator": "IN",
                "values": [
                    "SV", "WA"
                ]
            }
        ]
    }
}'

Body parameters

Parameter Name	Mandatory	Data Type	Example	Applicable Values	Description
filter	yes	object	-	-	Array of objects defining search conditions.
and	yes	array[object]	-	-	Logical operator.
property	yes	string	/type	/ipBlock/type /ipBlock/prefixLength /ipBlock/location/metroCode	Search field parameter.
operator	yes	string	=	= IN	Search field parameter operator.
values	yes	array[string]	["IP_BLOCK_PRODUCT"]	IP_BLOCK_PRODUCT	Search field parameter value.
/type	yes		"property": "/type", "operator": "=", "values": [       "IP_BLOCK_PRODUCT" ]		Product type.
operator	yes	string	=	=	Search field parameter operator.
values	yes	array[string]	["IP_BLOCK_PRODUCT"]	IP_BLOCK_PRODUCT	-
/account/accountNumber	no		"property": "/account/accountNumber", "operator": "=", "values": [      270001 ]		Billing account number.
operator	yes	string	=	=	Search field parameter operator.
values	yes	array[integer]	[270001]	-	-
/ipBlock/type	yes		"property": "/ipBlock/type", "operator": "=", "values": [     "IPv4" ]		IP addressing block type.
operator	yes	string	=	=	Search field parameter operator.
values	yes	array[string]	["IPv4"]	IPv4	IPv4 - IP version 4 addressing.
/ipBlock/prefixLength	yes		"property": "/ipBlock/prefixLength", "operator": "=", "values": [     29 ]		The number of bits in the IP address that identify the network.
operator	yes	string	=	=	Search field parameter operator.
values	yes	array[integer]	[29]	29
/ipBlock/location/metroCode	yes		"property": "/ipBlock/location/metroCode", "operator": "IN", "values": [    "SV", "WA", "AM" ]		Metropolitan area identifier.
operator	yes	string	IN	IN	Search field parameter operator.
values	yes	array[string]	["SV", "WA", "AM"]	Use the Get All Metros API request to retrieve the list of metros.	-

Sample response

{
    "data": [
        {
            "type": "IP_BLOCK_PRODUCT",
            "code": "ECX00005.PROD",
            "name": "Equinix Fabric IP Addressing Product",
            "description": "Equinix Fabric IP Addressing",
            "charges": [
                {
                    "type": "MONTHLY_RECURRING",
                    "price": 20.0
                }
            ],
            "currency": "USD",
            "ipBlock": {
                "type": "IPv4",
                "prefixLength": 29,
                "location": {
                    "metroCode": "SV"
                }
            }
        },
        {
            "type": "IP_BLOCK_PRODUCT",
            "code": "ECX00005.PROD",
            "name": "Equinix Fabric IP Addressing Product",
            "description": "Equinix Fabric IP Addressing",
            "charges": [
                {
                    "type": "MONTHLY_RECURRING",
                    "price": 160.0
                }
            ],
            "currency": "PLN",
            "ipBlock": {
                "type": "IPv4",
                "prefixLength": 29,
                "location": {
                    "metroCode": "WA"
                }
            }
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 2,
        "total": 2
    }
}

Response payload body description

Field  Name	Data Type	Example Values	Description
type	string	IP_BLOCK_PRODUCT	Product type.
code	string	ECX00005.PROD	Product code.
name	string	Equinix Fabric IP Addressing Product	Product name.
description	string	Equinix Fabric IP Addressing	Product description.
charges	array[object]	—	List of product offerings with properties and prices.
currency	string	USD	Product offering price currency.
ipBlock	object	—	IP block information.
charges
type	string	MONTHLY_RECURRING	Charge type.
price	number	20.0	Offering price.
ipBlock
type	string	IPv4	IP addressing block type. IPv4 - IP version 4 addressing.
prefixLength	integer	29	The number of bits in the IP address that identify the network.
location	object	—	Location information.
ipBlock.location
metroCode	string	SV	Metropolitan area identifier.
pagination
offset	integer	0	Index of the first item returned in the response.
limit	integer	2	Maximum number of items returned per page.
total	integer	2	Total number of items that match request criteria.

 

If you get “Access Denied” error, contact your local Equinix Service Desk for Equinix Fabric Portal access.