Solicitar instalação de equipamento

Pré-requisitos

1. Para obter detalhes sobre o Smart Hands, você precisa ter a permissão "Smart Hands".

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

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

4. Obter informações de localização - Envie uma solicitação GET para o endpoint /v1/orders/smarthands/locations 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 instalação de equipamento - exemplo mínimo

Para solicitar a instalação de equipamentos por um técnico da Equinix IBX, envie uma solicitação POST para o endpoint /v1/orders/smarthands/equipmentInstall. Especifique seus requisitos de instalação no corpo da solicitação.

Exemplo de solicitação cURL:

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/equipmentInstall"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "ibxLocation": {  
    "ibx": "AM1",  
    "cages": [  
      {  
        "cage": "AM1:0J:00JD11",  
        "accountNumber": "126854"  
      }  
    ]  
  },  
  "serviceDetails": {  
    "deviceLocation": "DHL tracking no. 1039 5739 92",  
    "elevationDrawingAttached": false,  
    "installationPoint": "Front and center.",  
    "patchDevices": true,  
    "patchingInfo": "When patching use the next available port, but maintain a symmetrical appearance.",  
    "powerItOn": true,  
    "mountHardwareIncluded": true,  
    "installedEquipmentPhotoRequired": true,  
    "scopeOfWork": "When installing make sure wires are all labeled."  
  },  
  "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"  
    }  
  ]  
}'

Exemplo de resposta:

{  
"OrderNumber": "1-190986534844"  
}

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

Pedido instalação de equipamento - exemplo estendido

Para solicitar a instalação de equipamentos por um técnico da Equinix IBX, envie uma solicitação POST para o endpoint /v1/orders/smarthands/equipmentInstall. Especifique seus requisitos de instalação no corpo da solicitação. Use o objeto attachments para incluir detalhes adicionais para o técnico.

observação

Antes de criar um pedido com anexo, chame o endpoint Arquivo de anexos.

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/equipmentInstall"  
-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": {  
    "deviceLocation": "DHL tracking no. 1039 5739 92",  
    "elevationDrawingAttached": true,  
    "installationPoint": "Front and center.",  
    "patchDevices": true,  
    "patchingInfo": "When patching use the next available port, but maintain a symmetrical appearance.",  
    "powerItOn": true,  
    "mountHardwareIncluded": true,  
    "installedEquipmentPhotoRequired": true,  
    "scopeOfWork": "When installing make sure wires are all labeled.",  
    "needSupportFromASubmarineCableStationEngineer": true  
  },  
  "attachments": [  
    {  
        "id": "fcb4a673-6308-456e-8f83-f745501d60ba",  
        "name": "Elevation drawing.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"  
    }  
  ]  
}'

Para obter uma lista completa dos parâmetros e descrições do corpo, consulte a Referência da API.