Ir para o conteúdo principal

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 terminal 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 ao /v1/orders/smarthands/locations terminal para recuperar os 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 cage, envie uma POST solicitação para o v1/orders/smarthands/picturesDocument terminal. 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 cage, envie uma POST solicitação para o v1/orders/smarthands/picturesDocument terminal. Forneça os detalhes do serviço no corpo da solicitação. Use o attachments objeto para incluir detalhes adicionais para um técnico.

observação

Antes de criar um pedido com anexo, ligue para o Attachments File terminal.

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 dos parâmetros e descrições do corpo, consulte a Referência do API .

Esta página foi útil?