Ir al contenido principal

Crear pedido de Cross Connects

Una conexión cruzada es un enlace de cable punto a punto entre dos clientes del mismo centro de datos Equinix IBX o de otro distinto. Las conexiones cruzadas sólo pueden ser solicitadas por un usuario del Portal del Cliente con permisos de pedido de Cross Connect & Intra-Facility Cables.

Este método crea una solicitud de pedido de Cross Connects entre dos clientes de Equinix (lado A y lado Z) en la misma ubicación IBX o en ubicaciones diferentes. El cliente del lado A inicia esta solicitud para conectarse al proveedor del lado Z.

Se pueden pedir cantidades únicas o múltiples de Cross Connects en una sola solicitud. Las conexiones cruzadas en cantidades múltiples sólo pueden enviarse en una solicitud de pedido si cumplen los siguientes criterios:

  • Todas las Cross Connects parten del mismo IBX, jaula y cuenta del lado A
  • Todas las Cross Connects terminan en el mismo proveedor, IBX y jaula del lado Z
  • El número total de Cross Connects en una solicitud no supera el 10

Si los Cross Connects que desea pedir no cumplen estos criterios, deberá enviar solicitudes de pedido por separado.

Requisitos previos

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

Información sobre la cara A

  1. Utilice el punto final GET Locations la información de ubicación para el punto de partida de su conexión cruzada (lado a). Determine el IBX exacto, el ID de jaula y el ID de armario. Asegúrese de que todas sus Cross Connects deseadas pertenecen al mismo IBX y jaula.

    Si desea parchear su equipo para esta conexión cruzada, el ID del armario se pasará en su solicitud por el siguiente parámetro a-side: cabinetId.

    Puede omitir este paso si ya conoce la información de ubicación de su lado a.

  2. Utilice la función GET Servicios de conexión para recuperar toda la información sobre los servicios de conexión de su ubicación preferida. Determine qué servicio de conexión, tipo de medio, tipo de conector y tipo de protocolo están disponibles en el IBX seleccionado.

    Estos valores también se pasarán en el cuerpo de la solicitud para los siguientes parámetros a-side: connectionService, mediaType, connectorType, protocolType.

    Puede omitir este paso si ya conoce la información de los servicios de conexión de su lado a.

  3. Utilice la función GET PatchPanels para determinar el ID del panel de conexiones preferido para su lado a. Este valor se pasará en el cuerpo de su solicitud para el siguiente parámetro a-side (parte de patchPanel objeto): id.

    Si desea obtener más información sobre su panel de conexiones, como los puertos disponibles y todos sus servicios de conexión, consulte GET PatchPanels {patchPanelId} en la sección Referencia API.

    Puede omitir este paso si ya conoce la información del panel de conexiones.

Información sobre el lado Z

  1. Utilice el punto final GET Proveedores para recuperar una lista de sus proveedores de servicios del lado z disponibles y determinar su número de cuenta.

  2. Utilice el punto final GET Locations la información de ubicación del destino de su cross connect (lado z). Determine el IBX exacto, el ID de jaula y el ID de armario. Asegúrese de que todas sus Cross Connects deseadas pertenecen al mismo IBX y jaula.

  3. Utilice la función GET Servicios de conexión para recuperar toda la información sobre los servicios de conexión de su ubicación preferida. Determine qué servicio de conexión, tipo de medio, tipo de conector y tipo de protocolo están disponibles en el IBX seleccionado.

    Estos valores se pasarán en el cuerpo de la solicitud para el siguiente parámetro del lado z: connectorType.

  4. Utilice la función GET PatchPanels para determinar el ID del panel de conexiones preferido para su lado a. Este valor se pasará en el cuerpo de su solicitud para el siguiente parámetro a-side (parte de patchPanel objeto): id.

  5. Consulte a su proveedor de servicios el número de referencia del cable de identificación del circuito. Este valor se pasará en el cuerpo de la solicitud para el parámetro del lado z circuitId.

    Puede saltarse este paso si ya conoce el ID del circuito.

Pedidos de Standard Cross Connect sin LOA

Para solicitar un Standard Cross Connect, envíe una solicitud POST al punto final /colocations/v2/orders/crossConnects.

Especifique el ID del panel de conexiones del lado a, los detalles completos de los servicios de conexión y el tipo de conector del lado Z, el ID del circuito y el ID del panel de conexiones en el cuerpo de la solicitud.

Un objeto de la matriz de detalles representa una conexión cruzada. Cuando solicite conexiones cruzadas múltiples, pase varios objetos en la matriz de detalles.

curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "details": [
    {
      "aSide": {
        "connectionService": "SINGLE_MODE_FIBER",
        "mediaType": "SINGLE_MODE_FIBER",
        "protocolType": "10_GIG_ETHERNET",
        "connectorType": "FC",
        "patchPanel": {
          "id": "CP:0104:1199890"
        }
      },
      "zSide": {
        "connectorType": "LC",
        "circuitId": "1-12312312",
        "patchPanel": {
          "id": "PP:0104:1190123"
        }
      }
    }
  ]
}'

Los parámetros incluidos en el cuerpo de la solicitud son específicos de este ejemplo. Para obtener una lista completa de los parámetros y sus descripciones, consulte la Referencia API.

Pedidos de Standard Cross Connect con una LOA

Para solicitar un Standard Cross Connect, envíe una solicitud POST al punto final /colocations/v2/orders/crossConnects.

Especifique el ID del panel de conexiones del lado A, los detalles completos de los servicios de conexión, y el tipo de conector del lado Z, el ID del circuito, el ID del panel de conexiones y el ID del accesorio LOA en el cuerpo de la solicitud.

Un objeto de la matriz de detalles representa una conexión cruzada. Cuando solicite conexiones cruzadas múltiples, pase varios objetos en la matriz de detalles.

Antes de crear un pedido con un archivo adjunto, utilice el punto final POST Archivo Adjunto .

Ejemplo de solicitud cURL:

curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "details": [
    {
      "aSide": {
        "connectionService": "SINGLE_MODE_FIBER",
        "mediaType": "SINGLE_MODE_FIBER",
        "protocolType": "10_GIG_ETHERNET",
        "connectorType": "FC",
        "patchPanel": {
          "id": "CP:0104:1199890"
        }
      },
      "zSide": {
        "providerName": "Acme Corporation",
        "ibx": "AM1",
        "loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba"
      }
    }
  ]
}'

Los parámetros incluidos en el cuerpo de la solicitud son específicos de este ejemplo. Para obtener una lista completa de los parámetros y sus descripciones, consulte la Referencia API.

Pedidos de Standard Cross Connects Ejemplo completo

Para solicitar un Standard Cross Connect, envíe una solicitud POST al punto final /colocations/v2/orders/crossConnects.

Este ejemplo es un pedido acelerado de conexiones cruzadas de una cuenta en una jaula con varias cuentas a un nuevo proveedor de servicios con LOA adjunta, junto con otros anexos, información y solicitudes.

Antes de crear un pedido con un archivo adjunto, utilice el punto final POST Archivo Adjunto .

Ejemplo de solicitud cURL:

curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "details": [
    {
      "aSide": {
        "connectionService": "SINGLE_MODE_FIBER",
        "mediaType": "SINGLE_MODE_FIBER",
        "protocolType": "10_GIG_ETHERNET",
        "connectorType": "FC",
        "mediaConverterRequired": false,
        "ifcCircuitCount": 2,
        "patchPanel": {
          "id": "CP:0104:1199890",
          "portA": 12,
          "portB": 13
        },
        "patchEquipment": {
          "cabinetId": "SG1:01:00EQ00:0001",
          "connectorType": "FC",
          "details": "Refer to attachment for patching details.",
          "port": 10
        }
      },
      "zSide": {
        "providerName": "Acme Corporation",
        "ibx": "PE2",
        "connectorType": "LC",
        "circuitId": "1-12312312",
        "patchPanel": {
          "id": "PP:0104:1190123",
          "portA": 1,
          "portB": 2
        },
        "loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba",
        "notificationEmail": "johndoe@acme.com"
      },
      "verifyLink": true,
      "circuitDeliveryDate": "2020-10-09T10:00:22.395Z",
      "submarineEngineerRequired": true
    }
  ],
  "expediteDateTime": "2020-10-10T06:30:22.395Z",
  "customerReferenceId": "EQX_CC_20201010",
  "description": "Please refer to attachment for full details for this cross connects order.",
  "attachments": [
    {
      "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",
      "name": "OrderInstructions.docx"
    }
  ],
  "purchaseOrder": {
    "type": "NEW",
    "number": "EQXPO_Ref9654284",
    "amount": 10000,
    "startDate": "2020-10-01",
    "endDate": "2021-09-30",
    "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"
  },
  "contacts": [
    {
      "type": "NOTIFICATION",
      "registeredUsers": [
        "john_doe",
        "john_doe1"
      ]
    },
    {
      "type": "TECHNICAL",
      "firstName": "Jane",
      "lastName": "Doe",
      "availability": "WORK_HOURS",
      "timezone": "America/New_York",
      "details": [
        {
          "type": "EMAIL",
          "value": "janedoe@acme.com"
        },
        {
          "type": "PHONE",
          "value": "+1-987654321"
        },
        {
          "type": "MOBILE",
          "value": "+1-912345678"
        }
      ]
    }
  ]
}'

Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

¿Fue útil esta página?