Ir para o conteúdo principal

Criar ordem de Cross Connect

Uma interconexão é uma ligação por cabo ponto a ponto entre dois clientes no mesmo centro de dados Equinix IBX ou em centros de dados diferentes. As interconexões só podem ser solicitadas por um usuário do Portal do Cliente com permissões para pedidos de interconexões e cabos intra-instalação.

Este método cria uma solicitação de interconexão entre dois clientes Equinix (lado A e lado Z) no mesmo local IBX ou em locais diferentes. O cliente do lado A inicia esta solicitação para se conectar ao provedor do lado Z.

É possível encomendar uma ou várias unidades de interconexões em um único pedido. Pedidos com múltiplas unidades de interconexões só podem ser submetidos em um único pedido se atenderem aos seguintes critérios:

  • Todas as interconexões partem do mesmo IBX do lado A, da mesma gaiola e da mesma conta.
  • Todas as interconexões terminam no mesmo provedor do lado Z, IBX e gaiola.
  • O número total de conexões cruzadas em uma solicitação não excede 10.

Se as conexões cruzadas que você deseja encomendar não atenderem a esses critérios, será necessário enviar solicitações de pedido separadas.

Pré-requisitos​

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

Informações do lado A​

  1. Use o método GET Locations%20Locations%20 por%20permission%No endpoint (código 20), indique a localização do ponto inicial da sua interconexão (lado A). Determine o IBX, o ID da gaiola e o ID do gabinete exatos. Certifique-se de que todas as interconexões desejadas pertençam ao mesmo IBX e gaiola.

    Se você deseja configurar seu equipamento para esta interconexão, o ID do gabinete será passado em sua solicitação para o seguinte parâmetro do lado A: cabinetId.

    Você pode pular esta etapa se já souber as informações de localização do seu lado A.

  2. Use os Serviços de Conexão GET%20list%20 de%20connection%20services) para recuperar todas as informações de serviços de conexão para o local desejado. Determine quais serviços de conexão, tipos de mídia, tipos de conector e tipos de protocolo estão disponíveis no IBX selecionado.

    Esses valores também serão passados ​​no corpo da solicitação para os seguintes parâmetros do lado A: connectionService, mediaType, connectorType, protocolType.

    Você pode pular esta etapa se já souber as informações dos serviços de conexão para o seu lado A.

  3. Use o GET PatchPanels%20all%20patch%20panels) para determinar o ID do painel de patch preferencial para o seu lado A. Esse valor será passado no corpo da sua solicitação para o seguinte parâmetro do lado A (parte de patchPanel). objeto): id.

    Se desejar obter mais informações sobre seu painel de conexão, como as portas disponíveis e todos os seus serviços de conexão, consulte GET PatchPanels {patchPanelId}%20patch%20panel%20details) na seção Referência da API.

    Você pode pular esta etapa se já souber as informações do painel de conexão.

Informações do lado Z​

  1. Use o GET Providers%20list%endpoint 20of%20providers) para recuperar uma lista de seus provedores de serviço z-side disponíveis e determinar o número da conta deles.

  2. Use o método GET Locations%20Locations%20 por%20permission%No endpoint (código 20), insira as informações de localização do destino da sua interconexão (lado Z). Determine o IBX, o ID da gaiola e o ID do gabinete exatos. Certifique-se de que todas as interconexões desejadas pertençam ao mesmo IBX e gaiola.

  3. Use os Serviços de Conexão GET%20list%20 de%20connection%20services) para recuperar todas as informações de serviços de conexão para o local desejado. Determine quais serviços de conexão, tipos de mídia, tipos de conector e tipos de protocolo estão disponíveis no IBX selecionado.

    Esses valores serão passados ​​no corpo da solicitação para o seguinte parâmetro do lado Z: connectorType.

  4. Use o GET PatchPanels%20all%20patch%20panels) para determinar o ID do painel de patch preferencial para o seu lado A. Esse valor será passado no corpo da sua solicitação para o seguinte parâmetro do lado A (parte de patchPanel). objeto): id.

  5. Consulte seu provedor de serviços para obter o número de referência do cabo Circuit ID. Esse valor será passado no corpo da solicitação para o parâmetro circuitId do lado Z.

    Você pode pular esta etapa se já souber o ID do circuito.

Encomendar conexões cruzadas padrão sem uma carta de autorização (LOA).​

Para encomendar uma conexão cruzada padrão, envie uma solicitação POST para [/colocations/v2/orders/crossConnects](/api-catalog/crossconnectsv2/#tag/Cross-Connects/operation/Order%20cross%ponto final (20 conexões).

Especifique o ID do painel de conexão do lado A, os detalhes completos dos serviços de conexão e o tipo de conector do lado Z, o ID do circuito e o ID do painel de conexão no corpo da solicitação.

Um objeto na matriz de detalhes representa uma interconexão. Ao ordenar múltiplas interconexões, passe múltiplos objetos na matriz de detalhes.

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

Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. Para obter uma lista completa dos parâmetros e suas descrições, consulte a Referência da API%20cross%20 conexões).

Encomendar conexões cruzadas padrão com uma LOA​

Para encomendar uma conexão cruzada padrão, envie uma solicitação POST para [/colocations/v2/orders/crossConnects](/api-catalog/crossconnectsv2/#tag/Cross-Connects/operation/Order%20cross%ponto final (20 conexões).

Especifique o ID do painel de conexão do lado A, os detalhes completos dos serviços de conexão e o tipo de conector do lado Z, o ID do circuito, o ID do painel de conexão e o ID do anexo LOA no corpo da solicitação.

Um objeto na matriz de detalhes representa uma interconexão. Ao ordenar múltiplas interconexões, passe múltiplos objetos na matriz de detalhes.

Antes de criar um pedido com um anexo, use o endpoint POST Attachments File.

Exemplo de solicitação 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"  
      }  
    }  
  ]  
}'

Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. Para obter uma lista completa dos parâmetros e suas descrições, consulte a Referência da API%20cross%20 conexões).

Exemplo completo de pedido de conexões cruzadas padrão​

Para encomendar uma conexão cruzada padrão, envie uma solicitação POST para [/colocations/v2/orders/crossConnects](/api-catalog/crossconnectsv2/#tag/Cross-Connects/operation/Order%20cross%ponto final (20 conexões).

Este exemplo é um pedido urgente de interconexões de uma conta em um ambiente com múltiplas contas para um novo provedor de serviços com carta de autorização (LOA) anexada, juntamente com outros anexos. Informações e solicitações.

Antes de criar um pedido com um anexo, use o endpoint POST Attachments File.

Exemplo de solicitação 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 obter uma lista completa dos parâmetros e suas descrições, consulte a Referência da API%20cross%20 conexões).

Esta página foi útil?