Nettoyage de la cage de contrôle

Conditions préalables

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

2. Authentifier - soumettre vos informations d'identification utilisateur, ID client et secret client pour l'authentification OAuth2. Reportez-vous à authentification API pour obtenir des instructions sur la façon d'appeler le API OAuth pour valider et authentifier vos informations d'identification.

3. Get Smart Hands types - envoie une GET demande au /v1/orders/smarthands/typesnoeud final 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.

4. Obtenir des informations sur l'emplacement : envoyez une GET demande au /v1/orders/smarthands/locationsnoeud 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.

Commander un nettoyage de cage - exemple minimal

Pour commander la suppression des déchets ou le nettoyage de la cage pour une cage spécifique, envoyez une POST demande au /smarthands/cageCleanupnoeud final. Spécifiez l'emplacement, le planning, les contacts et les détails du service dans le corps de la demande.

Exemple de requête cURL:

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/cageCleanup"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "ibxLocation": {  
    "ibx": "AM1",  
    "cages": [  
      {  
        "cage": "AM1:0J:00JD11",  
        "accountNumber": "126854"  
      }  
    ]  
  },  
  "serviceDetails": {  
    "permissionToDiscardBoxes": true,  
    "dampMoistMopRequired": true,  
    "scopeOfWork": "Light dusting of equipment, microfiber mop to be used."  
  },  
  "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"  
    }  
  ]  
}'

Pour une liste complète des paramètres corporels et des descriptions, voir la référence API .

Exemple de réponse:

{  
    "OrderNumber": "1-190368976438"  
}

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

Commander un nettoyage de cage - exemple détaillé

Pour commander la suppression des déchets ou le nettoyage de la cage pour une cage spécifique, envoyez une POST demande au /smarthands/cageCleanupnoeud final. Spécifiez l'emplacement, le planning, les contacts et les détails du service dans le corps de la demande. Utilisez l'attachmentsobjet pour inclure des détails supplémentaires pour un technicien.

remarque

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

curl -X   
POST "https://api.equinix.com/v1/orders/smarthands/cageCleanup"  
-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": {  
    "permissionToDiscardBoxes": true,  
    "dampMoistMopRequired": true,  
    "scopeOfWork": "Light dusting of equipment, microfiber mop to be used.",  
    "needSupportFromASubmarineCableStationEngineer": true  
  },  
  "attachments": [  
    {  
      "id": "fcb2k8763-2947-456e-8d68-f280753d60ba",  
      "name": "PhotoForCageCleanupServiceDetails.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 corporels et des descriptions, voir la référence API .