# Solicitar acesso à Internet com uma porta de tecido O Equinix Internet Access (EIA) oferece acesso híbrido à internet, utilizando múltiplos provedores de serviços de internet (ISPs) de nível 1 e pontos de troca de internet (IXs) da Equinix para proporcionar alta disponibilidade, confiabilidade e velocidade. * A conexão Fabric entre sua porta Fabric e o perfil de serviço de acesso à Internet da Equinix é fornecida gratuitamente. * Ao [desprovisionar sua instância de serviço de acesso à Internet](https://docs.equinix.com/pt-BR/internet-access/eia-api/deprovision-eia-api.md) , a conexão Fabric associada também é desprovisionada. * Caso haja algum problema com o provisionamento de uma instância do serviço de Acesso à Internet, a conexão Fabric associada será desprovisionada automaticamente. O Equinix Internet Access com Fabric está disponível para organizações integradas ao [Gerenciamento de identidade e acesso Equinix](https://docs.equinix.com/pt-BR/iam.md) , e a conta usada para enviar solicitações API deve ter a `Equinix Fabric Manager` função. Se sua organização não foi integrada ao Gerenciamento de identidade e acesso Equinix, você pode [solicitar Equinix Internet Access com porta dedicada](https://docs.equinix.com/pt-BR/internet-access/eia-api/order-eia-dedicated-port-api.md) . ## 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. 2. Determine as informações do A-Side. Para obter as informações da porta do Fabric, envie uma `GET` solicitação para o [`/fabric/v4/ports`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/ports/getports.md) endpoint. Você precisa do(s) UUID(s) da porta, o tipo de protocolo de link (DOT1Q ou QINQ). Se você estiver criando uma conexão redundante, escolha uma `PRIMARY` porta e uma `SECONDARY` porta. Você precisa dessas informações para a solicitação de criação de conexão. 3. Determine as informações do Z-Side. O perfil de serviço de acesso à Internet é do tipo `IA_PROFILE` e seu ID é `32d81829-0bf8-45d5-84e2-7289a553dbb6`. Para determinar a localização metropolitana do seu serviço, envie uma `GET` solicitação ao [`/internetAccess/v2/ibxs`](https://docs.equinix.com/pt-BR/api-catalog/internetaccessv2/product-availability/getibxs.md) terminal para encontrar os locais onde o acesso à Internet está disponível. Você precisa dessas informações para solicitar seu serviço de acesso à Internet. ## Criando uma conexão de acesso à Internet[​](#criando-uma-conexão-de-acesso-à-internet "Link direto para Criando uma conexão de acesso à Internet") Para criar a conexão para seu serviço de acesso à Internet, envie uma `POST` solicitação para o [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `IA_VC`. Forneça suas informações de porta no `aSide`objeto, incluindo: * `accessPoint.type` como `COLO` * Forneça o UUID da sua porta para `port.uuid` Se você estiver se conectando a partir de uma porta Dot1q: * LinkProtocol.type como `DOT1Q` * Forneça o ID do VLAN para `linkProtocol.vlanTag` Se você estiver se conectando a partir de uma porta QinQ: * LinkProtocol.type como `QINQ` * Forneça o ID da tag interna para `linkProtocol.vlanCTag` * Forneça o ID da tag externa para `linkProtocol.vlanSTag` * Se você estiver criando conexões redundantes, faça duas solicitações. Uma solicitação deve ter sua porta primária e `redundancy.priority` definida como `PRIMARY`e a outra sua porta secundária e `redundancy.priority` definida como `SECONDARY` e você deve especificar como o UUID da primeira conexão.`redundancy.group` Forneça o perfil de serviço de acesso à Internet no `zSide`objeto, incluindo: * `accessPoint.type` as `SP`. * `profile.type` como `IA_PROFILE` * `profile.uuid` como `32d81829-0bf8-45d5-84e2-7289a553dbb6` * `metroCode` Como o código estratégico de duas letras do metrô de acesso à Internet ao qual você está se conectando. Exemplos de requisições cURL: Exemplo de conexão primária ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "IA_VC", "name": "", "bandwidth": , "redundancy": { "priority": "PRIMARY" }, "aSide": { "accessPoint": { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "IA_PROFILE", "uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6" }, "location": { "metroCode": "" } } }, "project": { "projectId": "" }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` Exemplo de conexão secundária ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "IA_VC", "name": "", "bandwidth": , "redundancy": { "priority": "SECONDARY", "group": "" }, "aSide": { "accessPoint": { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "IA_PROFILE", "uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6" }, "location": { "metroCode": "" } } }, "project": { "projectId": "" }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` > **Importante** > > A resposta contém um `uuid` que é o ID de conexão do seu serviço de acesso à Internet. Você deve ter esse UUID de conexão para solicitar o serviço de acesso à Internet. ## Serviço de encomenda com bloco de IP atribuído pelo fornecedor[​](#serviço-de-encomenda-com-bloco-de-ip-atribuído-pelo-fornecedor "Link direto para Serviço de encomenda com bloco de IP atribuído pelo fornecedor") Para solicitar seu serviço de acesso à Internet, envie uma `POST` solicitação para o [`/internetAccess/v2/services`](https://docs.equinix.com/pt-BR/api-catalog/internetaccessv2/eia-service/createequinixinternetaccessv2.md) terminal. Para redundância, se você criou duas conexões para seu serviço, defina `type` como `DUAL`e forneça ambas as IDS de conexão ao `connections`array. Se você criou uma conexão única para seu serviço, defina `type` como `SINGLE` e forneça o ID da conexão ao `connections`array. No `routingProtocol`objeto, especifique: * Seu `routingProtocol.type` de `STATIC`, `DIRECT`ou `BGP`. * Ao solicitar seu serviço usando blocos IP de propriedade da Equinix (PA), defina o `ipBlock.prefixLength` valor para o tamanho do bloco IP necessário. > **Observação** > > Ao solicitar uma instância de serviço EIA localizada em um de nossos data centers IBX na região APAC, certifique-se de adicionar as `addressingPlans`informações e `questions`ao `ipBlock`objeto em caso de bloco IPv4 PA. Consulte a [referência do API](https://docs.equinix.com/pt-BR/api-catalog/internetaccessv2/eia-service/createequinixinternetaccessv2.md) para obter mais informações. ### Roteamento Estático[​](#roteamento-estático "Link direto para Roteamento Estático") A documentação sobre o roteamento estático pode ser encontrada [aqui](https://docs.equinix.com/pt-BR/internet-access/routing/static-routing.md). Exemplos de requisições cURL: Exemplo de serviço estático único na região da Ásia-Pacífico ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": , "addressingPlans": [ { "afterThreeMonths": , "immediate": , "purpose": "", "size": } ], "questions": [ { "answer": "YES", "type": "PRIVATE_SPACE_CONSIDERED" }, { "answer": "NO", "type": "REFUSED_PREVIOUSLY" }, { "answer": "NO", "type": "RETURNING_ADDRESS_SPACE" } ] } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemplo de serviço estático duplo ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### Roteamento direto[​](#roteamento-direto "Link direto para Roteamento direto") A documentação sobre o roteamento direto pode ser encontrada [aqui](https://docs.equinix.com/pt-BR/internet-access/routing/direct-routing.md). Exemplos de requisições cURL: Exemplo de Serviço Direto Único ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemplo de serviço direto duplo ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### Roteamento BGP[​](#roteamento-bgp "Link direto para Roteamento BGP") Especifique os detalhes da configuração do BGP no `routingProtocol`objeto: * Quais rotas você deseja anunciar para a Internet, `FULL`, `DEFAULT`, `FULL_DEFAULT`ou `PARTIAL` em `routingProtocol.exportPolicy`. * Forneça o intervalo de ASN do cliente BITS\_16 para ASN de 16 bits ou BITS\_32 para ASN de 32 bits em `routingProtocol.customerAsnRange`. * Forneça bgpAuthKey em`routingProtocol.bgpAuthKey`, se necessário. A documentação sobre roteamento BGP pode ser encontrada [aqui](https://docs.equinix.com/pt-BR/internet-access/routing/bgp-routing.md). Exemplos de requisições cURL: Exemplo de serviço BGP único ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "My Internet Access Service", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemplo de serviço BGP duplo ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## Serviço de pedidos com bloqueio de IP independente do provedor[​](#serviço-de-pedidos-com-bloqueio-de-ip-independente-do-provedor "Link direto para Serviço de pedidos com bloqueio de IP independente do provedor") Ao solicitar seu serviço usando seu próprio bloco IP (PI), especifique-o em `customerRoutes.prefix` ### Roteamento Estático[​](#roteamento-estático-1 "Link direto para Roteamento Estático") Exemplos de requisições cURL: Exemplo de serviço estático único ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemplo de serviço estático duplo ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### Roteamento direto[​](#roteamento-direto-1 "Link direto para Roteamento direto") Especifique quais IPs do seu bloco IP podem ser usados para fins de peering no `peering`objeto. Para o tipo de serviço único, forneça apenas um endereço IP no `equinixPeerIps`array. Para o tipo de serviço Duplo, forneça dois endereços IP no `equinixPeerIps`array e o endereço IP do VRRP no `equinixVRRPIp` campo. Exemplos de requisições cURL: Exemplo de Serviço Direto Único ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "" ] } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "" ] } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemplo de serviço direto duplo ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "", "" ], "equinixVRRPIp": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "", "" ], "equinixVRRPIp": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### Roteamento BGP[​](#roteamento-bgp-1 "Link direto para Roteamento BGP") Exemplos de requisições cURL: Exemplo de serviço BGP único ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemplo de serviço BGP duplo ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## Serviço de encomenda com blocos IP PA e PI[​](#serviço-de-encomenda-com-blocos-ip-pa-e-pi "Link direto para Serviço de encomenda com blocos IP PA e PI") Ao solicitar seu serviço com blocos de IP atribuídos pelo provedor (PA) e independentes do provedor (PI), especifique dois ou mais objetos de rota do cliente com os campos apropriados: * `ipBlock.prefixLength` No caso de bloco IP (PA) fornecido pela Equinix. * `customerRoutes.prefix` No caso de usar seu próprio bloco IP (PI). > **Importante** > > É possível solicitar vários blocos de IP apenas com os protocolos de roteamento estático e BGP. Exemplos de requisições cURL: Exemplo de blocos de IP atribuídos e independentes do provedor ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } }, { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } }, { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## Monitorando suas solicitações[​](#monitorando-suas-solicitações "Link direto para Monitorando suas solicitações") Para ver o status da sua solicitação de criação de conexão, envie uma `GET` solicitação para o [`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/getconnectionbyuuid.md) terminal. Para ver os detalhes do seu serviço de acesso à Internet, use o [`internetAccess/v2/services/{serviceId}`](https://docs.equinix.com/pt-BR/api-catalog/internetaccessv2/eia-service/getequinixinternetaccessservicedetails.md) terminal. Caso ocorra algum problema com o provisionamento da sua instância de serviço de Acesso à Internet, a conexão associada será desprovisionada automaticamente.