# Criar ordem de Cross Connect Um Cross Connect é um link de cabo ponto a ponto entre dois clientes no mesmo data center Equinix IBX ou em outro data center. O Cross Connects só pode ser solicitado por um usuário do Portal do Cliente com permissões de pedido de cabos Cross Connect e Intra-instalação. Esse método cria uma solicitação de pedido Cross Connects entre dois clientes Equinix (A-Side e Z-Side) no mesmo local ou em diferentes locais IBX. O cliente A-Side inicia essa solicitação para se conectar ao provedor Z-Side. Uma ou várias quantidades de Cross Connects podem ser solicitadas em uma única solicitação. As Cross Connects de várias quantidades só podem ser enviadas em uma solicitação de 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[​](#pré-requisitos "Link direto para Pré-requisitos") 1. Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para OAuth2. autenticação. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais. ### Informações do A-Side[​](#informações-do-a-side "Link direto para Informações do A-Side") 1. Use o ponto de extremidade[OBTER locais](https://docs.equinix.com/pt-BR/api-catalog/lookupv2/lookup/get%20locations%20by%20permission%20code.md) as informações de localização para o ponto de partida do seu Cross Connect (A-Side). Determine o IBX exato, o ID do cage e o ID do rack. Certifique-se de que todos os Cross Connects desejados pertençam ao mesmo IBX e cage. Se você quiser aplicar patch ao seu equipamento para este Cross Connect, o ID do rack será passado na sua solicitação para o seguinte parâmetro A-Side: `cabinetId`. Você pode pular esta etapa se já souber as informações de localização do seu lado A. 2. Use o [GET Connection Services](https://docs.equinix.com/pt-BR/api-catalog/lookupv2/lookup/retrieve%20list%20of%20connection%20services.md) para recuperar todas as informações de serviços de conexão para o local preferido. Determine qual serviço de conexão, tipo de mídia, tipo de conector e tipo 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 A-Side: `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](https://docs.equinix.com/pt-BR/api-catalog/lookupv2/lookup/retrieve%20all%20patch%20panels.md) para determinar o ID de patch panel preferido para o seu A-Side. O valor será passado no corpo da solicitação para o seguinte parâmetro A-Side (parte do patchPanel objeto): `id`. Para obter mais informações sobre o patch panel, como as portas disponíveis e todos os seus serviços de conexão, consulte [OBTER PatchPanels (patchPanelId)](https://docs.equinix.com/pt-BR/api-catalog/lookupv2/lookup/retrieve%20patch%20panel%20details.md) na seção Referência do API. Você pode pular esta etapa se já souber as informações do painel de conexão. ### Informações do Z-Side[​](#informações-do-z-side "Link direto para Informações do Z-Side") 1. Use o endpoint[GET Providers](https://docs.equinix.com/pt-BR/api-catalog/lookupv2/lookup/retrieve%20list%20of%20providers.md) para recuperar uma lista de seus provedores de serviços z-Side disponíveis e determinar o número da conta deles. 2. Use o endpoint[OBTER locais](https://docs.equinix.com/pt-BR/api-catalog/lookupv2/lookup/get%20locations%20by%20permission%20code.md) as informações de localização para o destino do seu Cross Connect (z-Side). Determine o IBX exato, o ID do cage e o ID do rack. Certifique-se de que todos os Cross Connects desejados pertençam ao mesmo IBX e cage. 3. Use o [GET Connection Services](https://docs.equinix.com/pt-BR/api-catalog/lookupv2/lookup/retrieve%20list%20of%20connection%20services.md) para recuperar todas as informações de serviços de conexão para o local preferido. Determine qual serviço de conexão, tipo de mídia, tipo de conector e tipo de protocolo estão disponíveis no IBX selecionado. Esses valores serão passados no corpo da solicitação para o seguinte parâmetro z-Side: `connectorType`. 4. Use o [GET PatchPanels](https://docs.equinix.com/pt-BR/api-catalog/lookupv2/lookup/retrieve%20all%20patch%20panels.md) para determinar o ID de patch panel preferido para o seu A-Side. O valor será passado no corpo da solicitação para o seguinte parâmetro A-Side (parte do patchPanel objeto): `id`. 5. Consulte seu provedor de serviços para obter o número de referência do cabo ID do circuito. O valor será passado no corpo da requisição para o parâmetro z-Side `circuitId`. Você pode pular esta etapa se já souber o ID do circuito. ## Pedido de Cross Connects padrão sem uma carta de autorização (LOA)[​](#pedido-de-cross-connects-padrão-sem-uma-carta-de-autorização-loa "Link direto para Pedido de Cross Connects padrão sem uma carta de autorização (LOA)") Para solicitar um Cross Connect padrão, envie uma `POST` solicitação para o [`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/pt-BR/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) terminal. 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 no array details representa um Cross Connect. Ao solicitar multi-Cross Connects, passe vários objetos no array de detalhes. ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -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 de parâmetros e suas descrições, consulte a [Referência API](https://docs.equinix.com/pt-BR/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) . ## Encomendar conexões cruzadas padrão com uma LOA[​](#encomendar-conexões-cruzadas-padrão-com-uma-loa "Link direto para Encomendar conexões cruzadas padrão com uma LOA") Para solicitar um Cross Connect padrão, envie uma `POST` solicitação para o [`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/pt-BR/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) terminal. 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 no array details representa um Cross Connect. Ao solicitar multi-Cross Connects, passe vários objetos no array de detalhes. Antes de criar um pedido com um anexo, use o ponto final[do arquivo de anexos POST](https://docs.equinix.com/pt-BR/api-catalog/attachmentsv1/attachments/createattachment.md) . Exemplo de solicitação cURL: ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -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 de parâmetros e suas descrições, consulte a [Referência API](https://docs.equinix.com/pt-BR/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) . ## Exemplo completo de pedido de conexões cruzadas padrão[​](#exemplo-completo-de-pedido-de-conexões-cruzadas-padrão "Link direto para Exemplo completo de pedido de conexões cruzadas padrão") Para solicitar um Cross Connect padrão, envie uma `POST` solicitação para o [`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/pt-BR/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) terminal. 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 ponto final[do arquivo de anexos POST](https://docs.equinix.com/pt-BR/api-catalog/attachmentsv1/attachments/createattachment.md) . Exemplo de solicitação cURL: ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -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 de parâmetros e suas descrições, consulte a [Referência API](https://docs.equinix.com/pt-BR/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) .