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.


Cross Connect Order

A cross connect is a point-to-point cable link between two customers in the same or different Equinix International Business Exchange™ (IBX®) data center. Cross connects can only be ordered by an Equinix Customer Portal user with Cross Connect & Intra-Facility Cables ordering permission.

 

See Integrate with Equinix Messaging Gateway for links on how to use the EMG Templates for ordering.

The following screenshots show sample message requests to create, update, and cancel Cross Connect in EMG.

Create Cross Connect

Sample Request:

{
"Task": {
"Id": "2352c576-fab3-4856-a431-0a4b55a2babe",
"Source": "3e095d30-40ff-11e9-8959-5be078353003",
"Verb": "Create",
"Resource": "CrossConnect",
"ContentType": "application/json",
"Version": "1.0",
"Body": {
"Operation": "0000",
"Attachments": [
{
"Name": "samplepicture.jpeg",
"Url": "https://eqixazurestorage.blob.core.windows.net/file-download-blob/samplepicture.jpeg"
}
],
"Description": "Create CrossConnect Order",
"RequestorId": "123456789",
"CustomerContact": demo@equinix.com,
"SchedulingDetails": {
"RequestedCompletionDate": ""
}
"ConnectionDetails": [
{
"ASide": {
"MediaType": "SINGLE_MODE_FIBER",
"PatchPanel": {
"Id": "PP:1234:123456",
"PortA": 43,
"PortB": -1
},
"ProtocolType": "DARK_FIBER",
"ConnectorType": "LC",
"ConnectionService": "SINGLE_MODE_FIBER"
},
"ZSide": {
"IBX": "SG3",
"ProviderName": "TestProvider",
"LOAAttachment": {
"Url": https://eqixazurestorage.blob.core.windows.net/file-download-blob/sampleloa.pdf,
"Name": "sampleloa.pdf"
}
}
}
]
}
},
"Signature": "RWNobwp7CiAgIklkIjogIjM1MGFlZjcwLTc4MWItMTFlOSogIH0KfQ=="
}

The description of the create request schema is as follows:

NameMandatoryTypeApplicable ValuesDescription
TaskYesObjectThe task object comprises a common set of header attributes and a unique set of body attributes. The header attributes are applicable to all order types, whereas the body attributes vary for each order.
IDYesString (Guid)The unique identifier of the message. Customers must ensure to send a unique value for each message.
SourceYesString (Guid)A unique value to identify the message sender. This value will be shared with the customer during the onboarding process.
VerbYesStringCreateIndicates the action to be performed.
ResourceYesStringCrossConnectIndicates the order type.
ContentTypeNoStringapplication/json
VersionYesString1.0The version of the request and response schema.
BodyYesObjectAn object containing the details of the order. The attributes within the object will vary based on the resource and verb.
SignatureYesStringBase64 encoded signature.
RequestorIdConditionalStringThe customer's reference number for this Cross Connect request. This attribute is only mandatory if RequestorIdUnique is true.
RequestorIdUniqueNoBooleantrue
false
Request that Customer reference should not be referenced in any other ticket.
If customer reference found, this operation will fail with "Bad Request", 400
This field cannot be NULL
OperationYesString0000Operation category. Currently only operation code 0000 is supported for Standard CrossConnect
CustomerContactYesStringThe username or email address of the user registered with Equinix Customer Portal.
DescriptionYesStringA detailed description of the scope of work. 
This field can only be up to 3800 characters long.
AttachmentsNoArray [{ String,  String }]

Includes all attachments for supporting this request.
Expected Value: [{"Name":<Attachment_Name>, "Url":<Attachment_URL>}]

5 files with 5MB size each

Supported filetypes: .bmp,.jpeg,.jpg,.gif,.png,.tif,.txt,.doc,.docx,.xls,.tiff,.xlsx,.ppt,.pptx,.pdf,.vsd,.pps,.ppsx.
SchedulingDetailsNoObjectRefer to the SchedulingDetails schema
Based on Scheduling Details, Equinix will determine Scheduling Type - Standard or Expedite
ConnectionDetailsYesArray[object,object,object]Refer to ASide, ZSide, & ServiceDetails schema
ASide &ZSide objects are MANDATORY, ServiceDetails are OPTIONAL
Dependant on Operation Code
AdditionalContactsNoArray[object]Refer to AdditionalContacts schema
Can be used to overide details of TECHNICAL CONTACT sent as part of "Contacts" attribute. You can send details of both registered and non-registered contacts with Equinix Customer Portal

SchedulingDetails schema:

NameMandatoryTypeApplicable ValuesDescription
RequestedCompletionDateConditionalString (ISO Date)Mandatory if Customer is raising a ticket for a date/time within 2-24 hours
Customer should always provide Equinix site local time
All timezone to be in UTC timezone with ISO format

AdditionalContacts schema:

NameMandatoryTypeApplicable ValuesDescription
ContactTypeYesStringTECHNICALType of Contact. Expected value : TECHNIICAL
FirstNameYesStringFirst Name of the Contact
Supported Regex: ^[\s.]([^\s.][\s.]){0,100}$
LastNameYesStringLast Name of the Contact
Supported Regex: ^[\s.]([^\s.][\s.]){0,100}$
EmailYesStringValid email address of the contact. Should be <=100 characters
Supported Regex: ^(([^<>()\[\]\.,;:\s@"]+(\.[^<>()\[\]\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$
WorkPhoneCountryCodeYesStringCountry Code of Primary Phone of the contact. Should be within [1…6] characters
Supported Regex: ^+[0-9]{1,6}$
WorkPhoneYesStringPrimary Phone of the contact. Should be within [1…40] characters
Supported Regex: ^[0-9\.\-() ]{2,40}(?:(x|ext)[0-9\.\-() ]{1,10})?$
WorkPhonePrefToCallNoStringNEVER
ANYTIME
MY_BUSINESS_HOURS
IBX_BUSINESS_HOURS
Defauted to 'ANYTIME'
WorkPhoneTimeZoneConditionalStringMandatory if WorkPhonePrefToCall = 'MY_BUSINESS_HOURS'
Expected values are "Atlantic/Canary" "Europe/Dublin" "Europe/London" "Europe/Lisbon" "Africa/Algiers" "Europe/Berlin" "Europe/Amsterdam" "Europe/Copenhagen" "Europe/Madrid" "Europe/Paris" "Europe/Stockholm" "Europe/Zurich" "Europe/Warsaw" "Africa/Cairo" "Africa/Johannesburg" "Europe/Sofia" "Africa/Nairobi" "Asia/Jerusalem" "Europe/Istanbul" "Europe/Moscow" "Asia/Riyadh" "Asia/Dubai" "Asia/Kabul" "Asia/Tehran" "Asia/Karachi" "Indian/Maldives" "Asia/Kolkata" "Asia/Kathmandu" "Asia/Omsk" "Asia/Rangoon" "Asia/Jakarta" "Asia/Ho_Chi_Minh" "Asia/Brunei" "Asia/Hong_Kong" "Asia/Kuala_Lumpur" "Asia/Manila" "Asia/Shanghai" "Asia/Singapore" "Asia/Taipei" "Australia/Perth" "Asia/Seoul" "Asia/Tokyo" "Australia/Darwin" "Australia/Brisbane" "Pacific/Guam" "Australia/Adelaide" "Australia/Sydney" "Pacific/Auckland" "Pacific/Chatham" "Indian/Christmas" "America/Scoresbysund" "Atlantic/South_Georgia" "America/Sao_Paulo" "America/Detroit" "America/New_York" "America/Puerto_Rico" "America/Toronto" "America/Bogota" "America/Chicago" "America/Winnipeg" "America/Denver" "America/Edmonton" "America/Mexico_City" "America/Los_Angeles" "America/Vancouver" "America/Phoenix" "America/Anchorage" "Pacific/Gambier" "Pacific/Marquesas" "Pacific/Honolulu" "Pacific/Fiji" "Asia/Muscat" "America/Argentina/Buenos_Aires" "America/Caracas" "Etc/GMT+12" "UTC" "GMT" "America/Santiago" "America/St_Johns" "Asia/Almaty" "Asia/Bankgkok" "Asia/Calcutta" "Asia/Magadan" "Asia/Yekaterinburg" "Australia/Eucla" "Australia/Lord_Howe" "Europe/Bratislava" "Europe/Brussels" "Europe/Prague" "Europe/Rome" "Pacific/Kiritimati" "Pacific/Midway" "Pacific/Tongatapu"
MobilePhoneCountryCodeYesStringCountry Code of Mobile Phone of the contact. Should be within [1…6] characters
Supported Regex: ^+[0-9]{1,6}$
MobilePhoneYesStringMobile Phone of the contact. Should be within [1…40] characters
Supported Regex: ^[0-9.-() ]{2,40}(?:(x
MobilePhonePrefToCallNoStringNEVER
ANYTIME
MY_BUSINESS_HOURS
IBX_BUSINESS_HOURS
Defauted to 'ANYTIME'
MobilePhoneTimeZoneConditionalStringMandatory if MobilePhonePrefToCall = 'MY_BUSINESS_HOURS'
Please refer to 'WorkPhoneTimeZone' for expected values

ConnectionDetails - ASide schema:

NameMandatoryTypeApplicable ValuesDescription
ConnectionServiceYesStringCOAX
MP4_CABLE
MULTI_MODE_FIBER
POTS
SINGLE_MODE_FIBER
UTP
Name of the available connection service
MediaTypeYesStringCOAX
MP4_CABLE
50_MICRON_MULTI_MODE_FIBER
50_MICRON_MULTI_MODE_FIBER_OM2
50_MICRON_MULTI_MODE_FIBER_OM3
50_MICRON_MULTI_MODE_FIBER_OM4
62.5_MICRON_MULTI_MODE_FIBER
62.5_MICRON_MULTI_MODE_FIBER_OM1
ABAM
CAT3
CAT5E
CAT6
CAT6A
OS1
SINGLE_MODE_FIBER
Name of media type.
ProtocolTypeYesStringANTENNA
DS-3
E1
E3
ETHERNET
FAST_ETHERNET
GIGABIT_ETHERNET
POTS
T1
FIBRE_CHANNEL
10_GIG_ETHERNET
100_GIG_ETHERNET
40_GIG_ETHERNET
DARK_FIBER
DWDM
56K
ISDN
OC-12
OC-192
OC-3
OC-48
STM-1
STM-16
STM-4
STM-64
NA
Name of protocol type.
ConnectorTypeYesMandatoryBNC
LC
FC
SC
ST
WIRE_WRAP
RJ45
E2000
RJ11
Name of connector type
PatchPanelConditionalObectId of the PacthPanel Installed in your Cage/Cabinet
MediaConverterRequiredNoBooleanWhen false, Equinix will not proceed with cross connect installation that requires media conversion
IfcCircuitCountNoNumberExpected Values: 1 to 10
PatchEquipmentNoObjectThis request will enable Equinix to install the cross connect from demarcation panel to your equipment.
It is chargeable service
Object { "Cabinet": "string", "ConnectorType": "string", "Details": "string", "Port": "number" }

ConnectionDetails - ZSide schema:

NameMandatoryTypeApplicable ValuesDescription
ConnectorTypeConditionalStringBNC
LC
FC
SC
ST
WRE_WRAP
RJ45
E2000
RJ11
Name of connector type.
Required ONLY if LOA Document is not provided
PatchPanelConditionalObectOptional if ZSide is a new provider
Id of the PacthPanel Installed in your Cage/Cabinet
CircuitIdNoStringCustomer or Carrier Circuit ID Cable Reference Number for verification purposes.
LOAAttachmentConditionalArray[string,string][{"Name":<Attachment_Name>, "Url":<Attachment_URL>}]
[{"Name":<Attachment_Name>, "Id":<Attachment_Id>}]
[{"Name":<Attachment_Name>, "Data":<Base64_Encoded_File_Bye_Array>]
Letter of Authorization (LOA)
Required ONLY if ZSide is a new provider
The attachment cannot be more than 5MB size
URL - URL to download the attachment
Id - Attachment Id returned by Equinix Attachment API (https://api.equinix.com/v1/attachments/file)
Supported filetypes: .bmp,.jpeg,.jpg,.gif,.png,.tif,.txt,.doc,.docx,.xls,.tiff,.xlsx,.ppt,.pptx,.pdf,.vsd,.pps,.ppsx
IBXConditionalStringEquinix DataCenter location code
Required ONLY if ZSide is a new provider
ProviderNameConditionalStringAccount name of the Service Provider
Required ONLY if ZSide is a new provider
NotificationEmailNoStringEmail id of the contact to be notified when cross connect is complete

ConnectionDetails - ServiceDetails schema:

NameMandatoryTypeApplicable ValuesDescription
DiverseConnectionsNoObject
Diversified cross connect or redundant cross connect for the availability.
If it is existing connection, Cross Connect serial number and type is mandatory.
Expected Values for Type: "NEW" "EXISTING", Default Value: "EXISTING"
If its a new redundant connection, A-Side and Z-Side is mandatory.
Refer to Aside & Zside sections for details of ASide & ZSide Object details
Object { "Type": "string", "SerialNumber": "string", "ASide": "Object", "ZSide": "Object" }
VerifyLinkNoBooleanWhen true, light link verification is carried out.
This may incur fixed fee based on your contract pricing.
CircuitDeliveryDateNoString (ISO Date)Carrier Circuit Delivery Date
SubmarineEngineerRequiredNoBooleanSet to true if submarine cable station engineer is required.
Default : false

Sample Response:

{
"Task": {"Id": "93667271-6ecc-4e9f-af20-e478f3bc1eba", "Source": "3e095d30-40ff-11e9-8959-5be078353003", "Verb": "Ack", "Resource": "CrossConnect", "ContentType": "application/json", "CreateTimeUTC": "2022-08-16T02:58:30.616Z", "Version": "1.0", "Body": {"Object": null, "ServicerId": "1-211433653662", "StatusCode": 202, "Description": "Equinix CrossConnect: 1-211433653662 Was Created", "RequestorId": null}, "OriginationId": "43e30aa2-bc03-405e-b6d9-6af87bd49137", "OriginationVerb": "Create"},
"Signature": "Jm2BpG/5ll6s3v0w3WWMULkRXsIEPog1e5AuYWT/kF3qW+hhNAFDZGCJ5lNmUT4Y3jUFid/3yb3diXK+Tr0hm7zwGLMDyi/mRwlc7LxYKRtbhHgHxWviQgTsLrreKlLuOJHbl81bCLxK2UEPrfRXuAOUbMyOT2mzBhidiCFg=="
}

The description of the update response schema is as follows:

NameTypeDescription
TaskObjectThe task object comprises a common set of header attributes and a unique set of body attributes. The header attributes are applicable to all order types, whereas the body attributes vary for each order.
IDString (Guid)The unique identifier of the message. Customers must ensure to send a unique value for each message.
SourceString (Guid)A unique value to identify the message sender. This value will be shared with the customer during the onboarding process.
VerbStringIndicates the action to be performed. The verb for response messages is "Ack".
ResourceStringIndicates the order type.
ContentTypeString
CreateTimeUTCIndicates the date and time at which the Cross Connect order was created at Equinix's end.
VersionStringThe version of the request and response schema.
BodyObjectAn object containing the details of the order. The attributes within the object will vary based on the resource and verb.
RequestorIdStringThe customer's reference number for this CrossConnect request.
ServicerIdStringIndicates the Cross Connect ID generated by Equinix after the order was submitted.
StatusCodeStringThe HTTP status code of the request.
DescriptionString

Additional details of the order created.

Ex: "Equinix CrossConnect: 1-199912345789 was created"
SignatureStringBase64 encoded signature.

Update Cross Connect

Sample Request:

{
"Task": {
"Id": "2352c576-fab3-4856-a431-0a4b55a2babe",
"Source": "3e095d30-40ff-11e9-8959-5be078353003",
"Verb": "Update",
"Resource": "CrossConnect",
"ContentType": "application/json",
"Version": "1.0",
"Body": {
"RequestorId": null,
"ServicerId": "1-199912345789",
"AppliesToAllCrossConnects": false,
"CrossConnectIds": [
{
"PatchPanelId": "PP:1234:123456",
"SerialNumber": "12345678"
}
],
"Attachments": [
{
"Name": "samplepicture.jpeg",
"Url": "https://eqixazurestorage.blob.core.windows.net/file-download-blob/samplepicture.jpeg"
}
],
"Description": "Update CrossConnect Order",
}
},
"Signature": "RWNobwp7CiAgIklkIjogIjM1MGFlZjcwLTc4MWItMTFlOSogIH0KfQ=="
}

The description of the update request schema is as follows:

NameMandatoryTypeApplicable ValuesDescription
TaskYesObjectThe task object comprises a common set of header attributes and a unique set of body attributes. The header attributes are applicable to all order types, whereas the body attributes vary for each order.
IDYesString (Guid)The unique identifier of the message. Customers must ensure to send a unique value for each message.
SourceYesString (Guid)A unique value to identify the message sender. This value will be shared with the customer during the onboarding process.
VerbYesStringUpdateIndicates the action to be performed.
ResourceYesStringCrossConnectIndicates the order type.
ContentTypeNoStringapplication/json
VersionYesString1.0The version of the request and response schema.
BodyYesObjectAn object containing the details of the order. The attributes within the object will vary based on the resource and verb.
SignatureYesStringBase64 encoded signature.
RequestorIdConditionalStringThe customer's reference number for this Cross Connect request. This attribute is only mandatory if RequestorIdUnique is true.
ServicerIdConditionalStringIndicates the Cross Connect order ID generated by Equinix after the order was submitted.
AppliesToAllCrossConnectsNoBooleanIf true
- For single Cross Connect order activity will get updated.
- For Multi Cross Connect order all activities will get updated
If false
- CrossConnectIds with valid SerialNumber is mandatory.
CrossConnectIdsConditionalarray[{ String, String }]Key value pair of PatchPanelIds,SerialNumbers
Restricted to only one object at a time
Refer to PatchPanelId and SerialNumber below.
Mandatory - If AppliesToAllCrossConnects is not provided or provided with value as false
AttachmentsNoArray [{ String,  String }]

Includes all attachments for supporting this request.
Expected Value: [{"Name":<Attachment_Name>, "Url":<Attachment_URL>}]

5 files with 5MB size each

Supported filetypes: .bmp,.jpeg,.jpg,.gif,.png,.tif,.txt,.doc,.docx,.xls,.tiff,.xlsx,.ppt,.pptx,.pdf,.vsd,.pps,.ppsx.
DescriptionYesStringA detailed description of the scope of work. 
This field can only be up to 3800 characters long.
PatchPanelIdNoStringPatchPanelIds of Asset which needs to be Updated.
SerialNumberYesStringSerialNumbers of Asset which needs to be Updated.

Sample Response:

{
"Task": {"Id": "93667271-6ecc-4e9f-af20-e478f3bc1eba", "Body": {"Object": null, "ServicerId": "1-211433653662", "StatusCode": 202, "Description": "Equinix CrossConnect: 1-211433653662 Was Updated", "RequestorId": null}, "Source": "3e095d30-40ff-11e9-8959-5be078353003", "Verb": "Ack", "Resource": "CrossConnect", "ContentType": "application/json", "CreateTimeUTC": "2022-08-16T02:58:30.616Z", "Version": "1.0", "OriginationId": "43e30aa2-bc03-405e-b6d9-6af87bd49137", "OriginationVerb": "Update"},
"Signature": "Jm2BpG/5ll6s3v0w3WWMULkRXsIEPog1e5AuYWT/kF3qW+hhNAFDZGCJ5lNmUT4Y3jUFid/3yb3diXK+Tr0hm7zwGLMDyi/mRwlc7LxYKRtbhHgHxWviQgTsLrreKlLuOJHbl81bCLxK2UEPrfRXuAOUbMyOT2mzBhidiCFg=="
}

The description of the update response schema is as follows:

NameTypeDescription
TaskObjectThe task object comprises a common set of header attributes and a unique set of body attributes. The header attributes are applicable to all order types, whereas the body attributes vary for each order.
IDString (Guid)The unique identifier of the message. Customers must ensure to send a unique value for each message.
SourceString (Guid)A unique value to identify the message sender. This value will be shared with the customer during the onboarding process.
VerbStringIndicates the action to be performed. The verb for response messages is "Ack".
ResourceStringIndicates the order type.
ContentTypeString
CreateTimeUTCIndicates the date and time at which the Cross Connect order was updated at Equinix's end.
VersionStringThe version of the request and response schema.
BodyObjectAn object containing the details of the order. The attributes within the object will vary based on the resource and verb.
RequestorIdStringThe customer's reference number for this CrossConnect request.
ServicerIdStringIndicates the Cross Connect ID generated by Equinix after the order was submitted.
StatusCodeStringThe HTTP status code of the request.
DescriptionString

Additional details of the order updated.

Ex: "Equinix CrossConnect: 1-199912345789 was updated"
SignatureStringBase64 encoded signature.

Cancel Cross Connect

Sample Request:

{
"Task": {
"Id": "740c7818-9fe7-4f33-8a44-5698081bf2c2",
"Source": "3e095d30-40ff-11e9-8959-5be078353003",
"Verb": "Update",
"Resource": "CrossConnect",
"ContentType": "application/json",
"Version": "1.0",
"Body": {
"RequestorId": null,
"ServicerId": "1-208273164070",
"State": "Cancelled",
"AppliesToAllCrossConnects": false
"CrossConnectIds": [
{
"PatchPanelId": "PP:0206:197904",
"SerialNumber": "21896638"
}
],
"Attachments": [],
"Description": "Cancel CrossConnect Order",
}
},
"Signature": "RWNobwp7CiAgIklkIjogIjM1MGFlZjcwLTc4MWItMTFlOSogIH0KfQ=="
}

The description of the cancel request schema is as follows:

NameMandatoryTypeApplicable ValuesDescription
TaskYesObjectThe task object comprises a common set of header attributes and a unique set of body attributes. The header attributes are applicable to all order types, whereas the body attributes vary for each order.
IDYesString (Guid)The unique identifier of the message. Customers must ensure to send a unique value for each message.
SourceYesString (Guid)A unique value to identify the message sender. This value will be shared with the customer during the onboarding process.
VerbYesStringUpdateIndicates the action to be performed.
ResourceYesStringCrossConnectIndicates the order type.
ContentTypeNoStringapplication/json
VersionYesString1.0The version of the request and response schema.
BodyYesObjectAn object containing the details of the order. The attributes within the object will vary based on the resource and verb.
SignatureYesStringBase64 encoded signature.
RequestorIdConditionalStringThe customer's reference number for this Cross Connect request. This attribute is only mandatory if RequestorIdUnique is true.
ServicerIdConditionalStringIndicates the Cross Connect order ID generated by Equinix after the order was submitted.
StateYesStringCancelledState as Cancelled
AppliesToAllCrossConnectsNoBooleanIf true
- For single Cross Connect order activity will get updated.
- For Multi Cross Connect order all activities will get updated
If false
- CrossConnectIds with valid SerialNumber is mandatory.
CrossConnectIdsConditionalarray[{ String, String }]Key value pair of PatchPanelIds,SerialNumbers
Single or Multi Cross Connect Key value can be provided.
Refer to PatchPanelId and SerialNumber below.
Mandatory - If AppliesToAllCrossConnects is not provided or provided with value as false
AttachmentsNoArray [{ String,  String }]

Includes all attachments for supporting this request.
Expected Value: [{"Name":<Attachment_Name>, "Url":<Attachment_URL>}]

5 files with 5MB size each

Supported filetypes: .bmp,.jpeg,.jpg,.gif,.png,.tif,.txt,.doc,.docx,.xls,.tiff,.xlsx,.ppt,.pptx,.pdf,.vsd,.pps,.ppsx.
DescriptionYesStringA detailed description of the scope of work. 
This field can only be up to 3800 characters long.
PatchPanelIdNoStringPatchPanelIds of Asset which needs to be Updated.
SerialNumberYesStringSerialNumbers of Asset which needs to be Updated.

Sample Response:

{
"Task": {"Id": "ba94938e-d585-4910-9e55-e89818fac002", "Body": {"Object": null, "ServicerId": "1-208273164070", "StatusCode": 202, "Description": "Equinix CrossConnect: 1-208273164070 Was Cancelled", "RequestorId": null}, "Source": "3e095d30-40ff-11e9-8959-5be078353003", "Verb": "Ack", "Resource": "CrossConnect", "ContentType": "application/json", "CreateTimeUTC": "2022-08-22T06:29:03.176Z", "Version": "1.0", "OriginationId": "32ade45d-551d-4fd8-91db-12929436ef2d", "OriginationVerb": "Update"},
"Signature": "Jm2BpG/5ll6s3v0w3WWMULkRXsIEPog1e5AuYWT/kF3qW+hhNAFDZGCJ5lNmUT4Y3jUFid/3yb3diXK+Tr0hm7zwGLMDyi/mRwlc7LxYKRtbhHgHxWviQgTsLrreKlLuOJHbl81bCLxK2UEPrfRXuAOUbMyOT2mzBhidiCFg=="
}

The description of the cancel response schema is as follows:

NameTypeDescription
TaskObjectThe task object comprises a common set of header attributes and a unique set of body attributes. The header attributes are applicable to all order types, whereas the body attributes vary for each order.
IDString (Guid)The unique identifier of the message. Customers must ensure to send a unique value for each message.
SourceString (Guid)A unique value to identify the message sender. This value will be shared with the customer during the onboarding process.
VerbStringIndicates the action to be performed. The verb for response messages is "Ack".
ResourceStringIndicates the order type.
ContentTypeString
CreateTimeUTCIndicates the date and time at which the CrossConnect order was cancelled at Equinix's end.
VersionStringThe version of the request and response schema.
OriginationIdString (Guid)The ID of the origination message, the value will be Null for an initial message.
OriginationVerbStringThe action to be performed by Equinix, the value will be Null for an initial message.
BodyObjectAn object containing the details of the order. The attributes within the object will vary based on the resource and verb.
RequestorIdStringThe customer's reference number for this Cross Connect order.
ServicerIdStringIndicates the CrossConnect order ID created after the order was submitted.
StatusCodeStringThe HTTP status code of the request.
DescriptionString

Additional details of the order cancelled.

Ex: "Equinix CrossConnect: 1-199912345789 Was Cancelled"
SignatureStringBase64 encoded signature.

Sample Outgoing Notification

For more information, refer to Order Notifications - Cross Connect.


{
"Task": {
"Id": "4f6ec8d0-902f-4892-aa31-8bfed1edc075",
"Source": "3e095d30-40ff-11e9-8959-5be078353003",
"Verb": "Update",
"Resource": "CrossConnect",
"ContentType": "application/json",
"CreationTimeUTC": "2020-05-21T02:08:11.471Z",
"Version": "1.0",
"Body": {
"RequestorId": "123456789",
"ServicerId": "1-199912345789",
"State": “InProgress",
"Description": "Ticket 1-199912345789 has been updated to InProgress state"
}
},
"Signature": "RWNobwp7CiAgIklkIjogIjM1MGFlZjcwLTc4MWIt9keSI6IHsKICAZXVlIgogIH0KfQ=="
}

The description of the outgoing message is as follows:

NameTypeDescription
TaskObjectThe task object comprises a common set of header attributes and a unique set of body attributes. The header attributes are applicable to all order types, whereas the body attributes vary for each order.
IDString (Guid)The unique identifier of the message. Equinix will send a unique value for each message.
SourceString (Guid)A unique value to identify the message sender. This value will be shared with the customer during the onboarding process.
VerbStringThe verb for outgoing messages is "Update". Indicates it is an update from Equinix on the submitted order.
ResourceStringIndicates the order type. For CrossConnect orders, the supported value is: CrossConnect
ContentTypeStringSupported Value : application/json
CreateTimeUTCStringIndicates the date and time at which the order was created at Equinix's end.
VersionStringThe version of the request and response schema.
BodyObjectAn object containing the details of the notification.
RequestorIdStringThe customer's reference number for this CrossConnect order.
ServicerIdStringId supplied by Equinix for the created Cross Connect Ticket
StatusCodeNoString
StateString

The current state of the submitted order.

Supported values:

Open - Customer order has been successfully submitted into Equinix IT systems.

InProgress - Customer order is being worked on by Equinix Datacenter Technician.

Closed - Customer order has been successfully completed by Equinix Datacenter Technician.

Cancelled - Customer order has been cancelled in Equinix IT systems based on customer request.

Pending Customer Input - Equinix Datacenter Technician has requested for additional information while working on customer order.

ActivityNoString
DescriptionString

Additional details of the order created

Ex: "Ticket 1-199912345789 has been updated to InProgress  state."
AttachmentsArray [{ String,  String }]

Includes all attachments for this request.

Supported Value: [{"Name":<Attachment_Name>, "Url":<Attachment_URL>}]

5 files with 5MB size each

Supported filetypes: .bmp,.jpeg,.jpg,.gif,.png,.tif,.txt,.doc,.docx,.xls,.tiff,.xlsx,.ppt,.pptx,.pdf,.vsd,.pps,.ppsx
SignatureStringBase64 encoded signature.