Commander l'installation d'un câble de brassage

Conditions préalables

1. Authentifier - Soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.

2. Récupérer le numéro de série du Cross-Connect - Envoyez une requête POST au point de terminaison /v1/assets/search pour rechercher le bon 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 Cross-Connect, vous devez utiliser "Serial # Not Found" comme numéro de série.

1. Pour obtenir les détails de Smart Hands, vous devez avoir l'autorisation de commander Smart Hands.

2. Obtenir les types de 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. Obtenir des informations sur la localisation - Envoyez une requête GET au point de terminaison /v1/orders/smarthands/locations pour récupérer les localisations IBX disponibles auxquelles vous avez accès. Vous pouvez sauter cette étape si vous connaissez déjà les informations de localisation.

Commandez l'installation d'un câble de raccordement

Pour commander l'installation de câbles de brassage par un technicien IBX d'Equinix, envoyez une requête POST au point de terminaison /smarthands/patchCableInstall. Précisez vos instructions d'installation dans le corps de la demande.

note

Avant de créer une commande avec une pièce jointe, appelez le Fichier de pièces jointes.

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/patchCableInstall"  
-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": "Next Available",  
        "scopeOfWork": "Refer to attachment for further instruction.",  
        "lightLinkVerification": true,  
        "needSupportFromASubmarineCableStationEngineer": true  
      }  
    ]  
  },  
  "attachments": [  
    {  
      "id": "fcb4a673-6308-456e-8f83-f745501d60ba",  
      "name": "PatchCabelInstallationInstruction.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": "janesmith"  
    }  
  ]  
}'

Pour une liste complète des paramètres du corps et des descriptions, voir 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.