Skip to main content

Effective 10 September 2024, API Documentation can be found on our Equinix Product Documentation site.
The content on this page will not be updated after 1 Oct 2024 and will be inaccessible after 31st Dec 2024.


Order Secure Cabinet

Order a Secure Cabinet, our business-ready cabinet with the most frequently deployed cabinet specifications. It includes an Equinix-supplied cabinet with 1200 mm minimum depth to accommodate most equipment needs.

Order Equinix Internet Access service

Prerequisites

To place an order for Secure Cabinet, you'll need:

  • A billing account registered for the country where you want to order colocation assets or add-ons.
  • The user account you plan to use to place your order, must have the Colocation Ordering permission assigned to it.

Step 1: Authenticate

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

Sample curl request

curl -X
POST 'https://api.equinix.com/oauth2/v1/token'
-H 'content-type: application/json'
-d '{
"grant_type": "password",
"client_id": "ABCDE12345",
"client_secret": "FGHIJ67890",
"user_name": "john.doe@example.com",
"user_password": "jd1@#$"
}'
 

Refer to Generating Client ID and Client Secret for instructions on how to create client ID and client secret. For further details on how to authorize your API requests, see Requesting Access and Refresh tokens.

 

If you don't know your user credentials for Equinix Customer Portal, contact your local Equinix Service Desk.


Step 2: Get Billing Accounts

Use the GET Accounts API request to list available billing accounts.

Sample curl request

curl -X
GET "https://api.equinix.com/v1/finance/accounts?offset=0&limit=2&sorts=ACCOUNT_NUMBER"
-H "authorization: Bearer qwErtY8zyW1abcdefGHI"

Sample response

{
"data": [
{
"accountNumber": "007",
"parentAccountNumber": "101230",
"accountName": "JOHN DOE CORPORATION",
"accountIbxs": [
"CH1",
"SV4"
]
},
{
"accountNumber": "1234",
"parentAccountNumber": "101230",
"accountName": "JOHN DOE LIMITED",
"accountIbxs": [
"DC3"
]
}
],
"page": {
"total": 11,
"limit": 2,
"offset": 0,
"sorts": [
"ACCOUNT_NUMBER"
]
},
"_links": {
"prev": {
"href": "/accounts?limit=2&offset=0&sorts=ACCOUNT_NUMBER"
},
"self": {
"href": "/accounts?limit=2&offset=0&sorts=ACCOUNT_NUMBER"
},
"next": {
"href": "/accounts?limit=2&offset=2&sorts=ACCOUNT_NUMBER"
}
}
}

Step 3: Determine Product Availability

Use the Get Availability API request to determine product availability.

Sample curl request

curl -X GET 'https://api.equinix.com/securecabinet/v1/availability/1234'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'

Sample response

[
{
"ibx": "CH1",
"maximumNumberOfCabinetsToOrder": 2,
"minimumDrawCapacityPerCabinet": 5,
"maximumDrawCapacityPerCabinet": 5,
"cabinetDimensions": {
"width": {
"value": 482,
"unit": "MILLIMETER"
},
"depth": {
"value": 482,
"unit": "MILLIMETER"
},
"height": {
"value": 482,
"unit": "MILLIMETER"
}
},
"acCircuitConfiguration": {
"voltage": 220,
"soldAmperage": 8.9,
"phase": "SINGLE"
"receptacle": "IEC 60309 1P+N+E"
},
"pduConfiguration": {
"model": "UU30009L"
},
"fabricPortSpeed": "SPEED_1_GBPS"
}
]

Step 4: Create Secure Cabinet Order

Use the Create Order API request to place your order.

Sample curl request

curl -X POST 'https://api.equinix.com/securecabinet/v1/orders'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
-d '{
"accountNumber": "132028",
"customerReference": "My Reference",
"endCustomerName": "Michael Scott Paper Co.",
"ibxCode": "SV10",
"contractTerm": "TERM_24_MONTHS",
"orderItem": {
"drawCapacity": 5,
"fabricPort": true,
"numberOfCabinets": 1,
"pdus": true
},
"purchaseOrderNumber": "8-132028",
"technicalContact": {
"firstName": "John",
"lastName": "Smith",
"email": "john@smith.com",
"phone": {
"number": "4915126449706",
"availability": "WORK_HOURS"
}
}
}'

Sample response

{
"orderNumber": "1-126546546546"
}
 

Use the Get Specified Order API request to monitor your Equinix Internet Access order.

curl -X GET 'https://api.equinix.com/colocations/v2/orders/1-126546546546'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'