Commande d'enlèvement de câbles de brassage

Conditions préalables
-
Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.
-
Récupérez le numéro de série du Cross Connect - envoyez une
POSTdemande au/v1/assets/searchterminal pour rechercher le numéro de série Cross Connect correct. Vous pouvez ignorer cette étape si vous avez déjà le numéro de série.Si vous ne trouvez pas le numéro de série du Cross Connect, utilisez-le
"Serial # Not Found"comme numéro de série. -
Pour obtenir les détails Smart Hands, vous devez disposer de
Smart Handsl'autorisation de commande. -
Obtenir les types de Smart Hands - envoyez une
GETdemande au/v1/orders/smarthands/typesterminal pour obtenir tous les types de commande Smart Hands. Vous pouvez ignorer cette étape si vous connaissez déjà le type de commande Smart Hands. -
Obtenir des informations de localisation : envoyez une
GETdemande au/v1/orders/smarthands/locationspoint final pour récupérer les emplacements IBX disponibles auxquels vous avez accès. Vous pouvez ignorer cette étape si vous connaissez déjà les informations de localisation.
Commandez l'enlèvement du câble de raccordement
Pour commander le retrait du câble de raccordement par un technicien Equinix IBX, envoyez une POST demande au v1/orders/smarthands/patchCableRemovalterminal. Spécifiez les détails de la suppression dans le corps de la demande.
Cette opération ne peut être effectuée que par un utilisateur ayant l'autorisation de commander des Smart Hands.
Exemple de cURL pour l'enlèvement d'un câble de raccordement sans informations, pièces jointes ou contacts supplémentaires :
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/patchCableRemoval"
-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": {
"crossConnects": [
{
"serialNumber": "123456789",
"deviceCabinet": "501",
"deviceConnectorType": "FC",
"deviceDetails": "Router1",
"devicePort": "1"
}
]
},
"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"
}
]
}'
Exemple de cURL pour l'enlèvement d'un câble de raccordement avec des informations supplémentaires, des pièces jointes et des contacts :
Avant de créer une commande avec pièce jointe, appelez le Attachments File terminal.
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/patchCableRemoval"
-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": {
"crossConnects": [
{
"serialNumber": "123456789",
"deviceCabinet": "501",
"deviceConnectorType": "FC",
"deviceDetails": "Router1",
"devicePort": "1",
"removePatchCableWithLiveTraffic": true,
"scopeOfWork": "Refer to attachment for further instruction.",
"needSupportFromASubmarineCableStationEngineer": true
}
]
},
"attachments": [
{
"id": "fcb4a673-6308-456e-8f83-f745501d60ba",
"name": "PatchCabelRemovalInstruction.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"
}
]
}'
Pour obtenir une liste complète des paramètres corporels et des descriptions, reportez-vous à la référence API .
Exemple de réponse :
{
"OrderNumber": "1-457809872838"
}
La réponse indique que la commande a abouti et renvoie le numéro de commande.