Order cage escort
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.
-
Get a Work Visit order number - Send a
GET
request to the [/colocations/v2/orders/{orderId}
](/api-catalog/ordersv2/#tag/Orders/operation/GET Order details) endpoint to retrieve an order number for a work visit that has already been scheduled. To schedule a new work visit, send aPOST
request to the [colocations/v2/orders/workVisits
](/api-catalog/workvisitsv2/#tag/Work-Visit/operation/Schedule Work Visit Services) endpoint. You must haveIBX Access Services
permission to schedule a work visit. You may skip this step if you already have the work visit order number. -
To get Smart Hands details, the user must have
Smart Hands
ordering permissions. -
Get Smart Hands Types - Send a
GET
request to the/v1/orders/smarthands/types
endpoint to get all Smart Hands order types. You may skip this step if you already know the Smart Hands order type. -
Get Location Information - Send a
GET
request to the/v1/orders/smarthands/locations
endpoint to retrieve available IBX locations that you have access to. You may skip this step if you already know the location information.
Order a Cage Escort - minimal example
To order an IBX security escort for a visitor to access your cage, send a POST
request to the /smarthands/cageEscort
endpoint.
Sample cURL Request:
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/cageEscort"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00JD11",
"accountNumber": "126854"
}
]
},
"serviceDetails": {
"workVisitOrderNumber": "1-19864326570532",
"openCabinetForVisitor": true,
"supervisionReqForVisitor": true,
"durationVisit": "4 Hours",
"scopeOfWork": "If staff from customer company is unable to attend, please continue to accompany the visitor."
},
"schedule": {
"scheduleType": "SCHEDULED_MAINTENANCE",
"requestedStartDate": "2019-08-30T22:00:49.776Z",
"requestedCompletionDate": "2019-08-31T22:00:49.776Z"
},
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe"
},
{
"contactType": "TECHNICAL",
"userName": "johndoe",
"workPhonePrefToCall": "ANYTIME"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe"
}
]
}'
Sample Response:
{
"OrderNumber": "1-19876653568916"
}
The response indicates the order was successful and returns the order number.
Order a Cage Escort - extended example
Sample cURL Request:
To order an IBX security escort for a visitor to access your cage, send a POST
request to the /smarthands/cageEscort
endpoint. Provide the service details in the body of the request. Use the attachments
object to include additional details for a technician.
Before creating an order with attachment, call the Attachments File
endpoint.
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/cageEscort"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00JD11",
"cabinets": [
"AM1:0J:00JD11:0001"
],
"accountNumber": "126854"
}
]
},
"serviceDetails": {
"workVisitOrderNumber": "1-19864326570532",
"openCabinetForVisitor": true,
"supervisionReqForVisitor": true,
"durationVisit": "4 Hours",
"scopeOfWork": "If staff from customer company is unable to attend, please continue to accompany the visitor.",
"needSupportFromASubmarineCableStationEngineer": true
},
"attachments": [
{
"id": "fcb2k8763-2947-456e-8d68-f280753d60ba",
"name": "WorkVisitInstructions.docx"
}
],
"schedule": {
"scheduleType": "SCHEDULED_MAINTENANCE",
"requestedStartDate": "2019-08-30T22:00:49.776Z",
"requestedCompletionDate": "2019-08-31T22:00:49.776Z"
},
"customerReferenceNumber": "EQX-PO2019-08-001",
"purchaseOrder": {
"purchaseOrderType": "EXEMPTED",
"attachment": {
"id": "abc1fd2e-345f-67g4-hi89-01jk234l5m6n",
"name": "PurchaseOrderExemptionForm123.docx"
}
},
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe"
},
{
"contactType": "TECHNICAL",
"name": "Jane Smith",
"email": "janesmith@corporation.com",
"workPhoneCountryCode": "+44",
"workPhone": "0148211111",
"workPhonePrefToCall": "MY_BUSINESS_HOURS",
"workPhoneTimeZone": "Europe/London",
"mobilePhoneCountryCode": "+44",
"mobilePhone": "0123456789",
"mobilePhonePrefToCall": "MY_BUSINESS_HOURS",
"mobilePhoneTimeZone": "Europe/London"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe"
},
{
"contactType": "NOTIFICATION",
"userName": "jillsnow"
}
]
}'
For a complete list of body parameters and descriptions, see the API Reference.