Solicite fotos o documentación de su jaula

Requisitos previos

1. Para obtener los detalles de Smart Hands, debe tener Smart Hands permiso.

2. Autenticar: Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales.

3. Obtener tipos de Smart Hands - Enviar una GET solicitud al /v1/orders/smarthands/types endpoint para obtener todos los tipos de órdenes de Smart Hands. Puede omitir este paso si ya conoce el tipo de orden Smart Hands.

4. Obtener información de ubicación: Envíe una GET solicitud al /v1/orders/smarthands/locations endpoint para recuperar las ubicaciones de IBX disponibles a las que tenga acceso. Puede omitir este paso si ya conoce la información de ubicación.

Pedir fotos o documentación de la jaula - ejemplo mínimo

Para solicitar a un técnico de IBX que proporcione imágenes o documentación relacionadas con la jaula, envíe una POST solicitud al v1/orders/smarthands/picturesDocumentpunto final. Proporcione los detalles del servicio en el cuerpo de la solicitud.

Ejemplo de solicitud cURL:

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/picturesDocument"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "ibxLocation": {  
    "ibx": "AM1",  
    "cages": [  
      {  
        "cage": "AM1:0J:00JD11",  
        "accountNumber": "126854"  
      }  
    ]  
  },  
  "serviceDetails": {  
    "documentOnly": false,  
    "cameraProvidedBy": "Equinix",  
    "specificDateAndTime": true,  
    "description": "Take a photo of the patch panel cable arrangement, to include all labels clearly.",  
    "scopeOfWork": "Indicate what camera was used, and provide the photos in print size 3.6 x 3.007 inches.",  
  },  
  "schedule": {  
    "scheduleType": "SCHEDULED_MAINTENANCE",  
    "requestedStartDate": "2019-08-30T22:00:49.776Z",  
    "requestedCompletionDate": "2019-08-31T22:00:49.776Z"  
  },  
  "purchaseOrder": {  
    "purchaseOrderType": "NEW",  
    "number": "1037503648"  
  },  
  "contacts": [  
    {  
      "contactType": "ORDERING",  
      "userName": "johndoe"  
    },  
    {  
      "contactType": "TECHNICAL",  
      "userName": "johndoe",  
      "workPhonePrefToCall": "ANYTIME"  
    },  
    {  
      "contactType": "NOTIFICATION",  
      "userName": "johndoe"  
    }  
  ]  
}'

Respuesta de muestra:

{  
  "OrderNumber": "1-457809872838"  
}

La respuesta indica que el pedido se ha realizado correctamente y devuelve el número de pedido.

Pedir fotos o documentación de la jaula - ejemplo ampliado

Para solicitar a un técnico de IBX que proporcione imágenes o documentación relacionadas con la jaula, envíe una POST solicitud al v1/orders/smarthands/picturesDocumentpunto final. Proporcione los detalles del servicio en el cuerpo de la solicitud. Utilice el attachments objeto para incluir detalles adicionales para un técnico.

nota

Antes de crear una orden con adjunto, llame al Attachments File punto final.

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/picturesDocument"  
-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": {  
    "documentOnly": false,  
    "cameraProvidedBy": "Equinix",  
    "specificDateAndTime": true,  
    "description": "Take a photo of the patch panel cable arrangement, to include all labels clearly.",  
    "scopeOfWork": "Indicate what camera was used, and provide the photos in print size 3.6 x 3.007 inches.",  
    "needSupportFromASubmarineCableStationEngineer": true  
  },  
  "attachments": [  
    {  
      "id": "fcb2k8763-2947-456e-8d68-f280753d60ba",  
      "name": "SupportingPhotos.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"  
    }  
  ]  
}'

Para obtener una lista completa de los parámetros y descripciones del cuerpo, consulte la Referencia API .