Solicite fotos ou documentação da sua gaiola.

Pré-requisitos

1. Para obter detalhes do Smart Hands, você deve ter Smart Hands permissão.

2. Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para autenticação OAuth2. Consulte Autenticação API para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais.

3. Get Smart Hands Types - Envie uma GET solicitação para o /v1/orders/smarthands/types endpoint para obter todos os tipos de pedidos Smart Hands. Você pode ignorar esta etapa se já souber o tipo de pedido Smart Hands.

4. Obter informações de localização - Envie uma GET solicitação para o /v1/orders/smarthands/locations ponto de extremidade para recuperar locais IBX disponíveis aos quais você tem acesso. Você pode pular esta etapa se já souber as informações de localização.

Pedido fotos ou documentação da Cage - exemplo mínimo

Para solicitar que um técnico da IBX forneça imagens ou documentação relacionadas ao compartimento, envie uma POST solicitação para o v1/orders/smarthands/picturesDocument endpoint. Forneça os detalhes do serviço no corpo da solicitação.

Exemplo de solicitação 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"  
    }  
  ]  
}'

Exemplo de resposta:

{  
  "OrderNumber": "1-457809872838"  
}

A resposta indica que o pedido foi bem-sucedido e retorna o número do pedido.

Pedido fotos ou documentação da Cage - exemplo estendido

Para solicitar que um técnico da IBX forneça imagens ou documentação relacionadas ao compartimento, envie uma POST solicitação para o v1/orders/smarthands/picturesDocument endpoint. Forneça os detalhes do serviço no corpo da solicitação. Use o attachments objeto para incluir detalhes adicionais de um técnico.

observação

Antes de criar um pedido com anexo, chame o Attachments File endpoint.

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 obter uma lista completa de parâmetros corporais e descrições, consulte a Referência do API .