Criar ordem de conexão cruzada

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 solicitar de pedido de cross connects entre dois clientes Equinix (lado A e lado Z) no mesmo local IBX ou em locais diferentes. O cliente do lado A inicia essa solicitar para conectar a provedor do lado Z.

Quantidades únicas ou múltiplas de cross connects podem ser solicitadas em uma única solicitar. cross connects com quantidades múltiplas só podem ser enviadas em uma pedido solicitar se atenderem aos seguintes critérios:

Todas as conexões cruzadas começam no mesmo IBX do lado A, gaiola e conta
Todas as conexões cruzadas 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 os cross connects que você deseja encomendar não atenderem a esses critérios, você precisará enviar solicitações de pedido separadas.

Pré-requisitos

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

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á você as informações de localização do seu lado A.
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á você as informações dos serviços de conexão do seu lado A.
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á você as informações do patch panel .

Informações do lado Z

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.
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.
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.
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.
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á você o ID do circuito.

Como Pedindo Cross Connects padrão sem 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 patch panel do lado A, detalhes completos dos serviços de conexão e o tipo de conector do lado Z, o ID do circuito e o ID do patch panel no corpo da solicitar.

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

Pedindo Cross Connects Padrão com uma LOA

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

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

Exemplo completo de Pedindo de Cross Connects padrão

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

Pré-requisitos​

Informações do lado A​

Informações do lado Z​

Como Pedindo Cross Connects padrão sem uma LOA​

Pedindo Cross Connects Padrão com uma LOA​

Exemplo completo de Pedindo de Cross Connects padrão​