Pedido de retirada de cables de interconexión

Requisitos previos

1. 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.

2. Recuperar el número de serie del Cross Connect - Envíe una solicitud POST al punto final /v1/assets/search para buscar el número de serie correcto del Cross Connect. Puede omitir este paso si ya dispone del número de serie.

Si no puede encontrar el número de serie de la conexión cruzada, debe utilizar "Serial # Not Found" como número de serie.

1. Para obtener los detalles de Smart Hands, debe disponer del permiso de pedido Smart Hands.

2. 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.

3. 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 retirada del cable de conexión

Para solicitar la retirada de un cable de parcheo por parte de un técnico IBX de Equinix, envíe una solicitud POST al punto final v1/orders/smarthands/patchCableRemoval. Especifique los detalles de la retirada en el cuerpo de la solicitud.

Esto sólo puede hacerlo un usuario con permiso para ordenar Smart Hands.

Ejemplo de cURL para la retirada de cables de parcheo sin información adicional, archivos adjuntos ni contactos:

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/patchCableRemoval"  
-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": {  
    "crossConnects": [  
      {  
        "serialNumber": "123456789",  
        "deviceCabinet": "501",  
        "deviceConnectorType": "FC",  
        "deviceDetails": "Router1",  
        "devicePort": "1"  
      }  
    ]  
  },  
  "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"  
    }  
  ]  
}'

Ejemplo de cURL para la retirada de cables de parcheo con información adicional, archivos adjuntos y contactos:

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/patchCableRemoval"  
-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": {  
    "crossConnects": [  
      {  
        "serialNumber": "123456789",  
        "deviceCabinet": "501",  
        "deviceConnectorType": "FC",  
        "deviceDetails": "Router1",  
        "devicePort": "1",  
        "removePatchCableWithLiveTraffic": true,  
        "scopeOfWork": "Refer to attachment for further instruction.",  
        "needSupportFromASubmarineCableStationEngineer": true  
      }  
    ]  
  },  
  "attachments": [  
    {  
      "id": "fcb4a673-6308-456e-8f83-f745501d60ba",  
      "name": "PatchCabelRemovalInstruction.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 del cuerpo y las descripciones, consulte la Referencia de la API.

Respuesta de muestra:

{  
  "OrderNumber": "1-457809872838"  
}

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