Commande de retrait du câble de brassage

Préalable

1. Authentification: soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète pour l’authentification OAuth2. Consultez la documentation relative à l’authentification API (Authentification API) pour savoir comment appeler l’API OAuth afin de valider et d’authentifier vos identifiants.

2. Récupérez le numéro de série du Cross Connect: envoyez une requête POST au point de terminaison /v1/assets/search pour rechercher le numéro de série du Cross Connect. Vous pouvez sauter 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 connecteur croisé, vous devez utiliser « N° de série introuvable » comme numéro de série.

1. Pour obtenir les détails de Smart Hands, vous devez disposer de l'autorisation de commande « Smart Hands ».

2. Obtenir les types de commandes Smart Hands: envoyez une requête GET au point de terminaison /v1/orders/smarthands/types pour obtenir tous les types de commandes Smart Hands. Vous pouvez sauter cette étape si vous connaissez déjà le type de commande Smart Hands.

3. Récupérer les informations de localisation: envoyez une requête GET au point de terminaison /v1/orders/smarthands/locations pour obtenir les emplacements IBX disponibles auxquels vous avez accès. Vous pouvez sauter cette étape si vous connaissez déjà les informations de localisation.

Commande de retrait de câble de raccordement

Pour demander le retrait d'un câble de brassage par un technicien Equinix IBX, envoyez une requête POST au point de terminaison v1/orders/smarthands/patchCableRemoval. Précisez les détails du retrait dans le corps de la requête.

Cela ne peut être effectué que par un utilisateur disposant de l'autorisation de commande Smart Hands .

Exemple de commande cURL pour le retrait de câbles de brassage sans renseignements supplémentaires, pièces jointes ou contacts:

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 commande cURL pour le retrait de câbles de brassage avec des informations supplémentaires, des pièces jointes et contacts:

remarque

Avant de créer une commande avec pièce jointe, appelez le point de terminaison Attachments File.

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 une liste complète des paramètres et descriptions du corps, voir la référence de l'API.

Exemple de réponse:

{  
  "OrderNumber": "1-457809872838"  
}

La réponse indique que la commande a été prise en compte et retourne le numéro de commande.