Pedir la instalación de equipos

Requisitos previos

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

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

3. Obtener tipos de Smart Hands - Envíe una solicitud GET al punto final /v1/orders/smarthands/types para obtener todos los tipos de pedidos de Smart Hands. Puede omitir este paso si ya conoce el tipo de pedido de Smart Hands.

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

Ordenar la instalación de equipos - ejemplo mínimo

Para solicitar la instalación de equipos por parte de un técnico IBX de Equinix, envíe una solicitud POST al punto final /v1/orders/smarthands/equipmentInstall. Especifique sus requisitos de instalación en el cuerpo de la solicitud.

Ejemplo de solicitud 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"  
    }  
  ]  
}'

Respuesta de muestra:

{  
"OrderNumber": "1-190986534844"  
}

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

Pedir la instalación de equipos - ejemplo ampliado

Para solicitar la instalación de equipos por parte de un técnico IBX de Equinix, envíe una solicitud POST al punto final /v1/orders/smarthands/equipmentInstall. Especifique sus requisitos de instalación en el cuerpo de la solicitud. Utilice el objeto attachments para incluir detalles adicionales para un técnico.

nota

Antes de crear un pedido con archivo adjunto, llame al punto final Attachments File.

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 obtener una lista completa de los parámetros del cuerpo y sus descripciones, consulte la Referencia de la API.