Ir para o conteúdo principal

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

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 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 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 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​

Para criar a conexão para seu serviço de acesso à Internet, envie uma POST solicitação para o /fabric/v4/connections terminal. A conexão type é IA_VC.

Forneça suas informações de porta no aSideobjeto, 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 PRIMARYe 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 zSideobjeto, 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 <token>' \
-d '{
"type": "IA_VC",
"name": "<your_connection_name>",
"bandwidth": <connection_speed>,
"redundancy": {
"priority": "PRIMARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "<your_port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": <vlan_id>
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"type": "IA_PROFILE",
"uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6"
},
"location": {
"metroCode": "<metro_code>"
}
}
},
"project": {
"projectId": "<project_id>"
},
"order": {
"purchaseOrderNumber": "<purchase_order_number>"
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>"
]
}
]
}'
Exemplo de conexão secundária
curl -X POST 'https://api.equinix.com/fabric/v4/connections' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"type": "IA_VC",
"name": "<your_connection_name>",
"bandwidth": <connection_speed>,
"redundancy": {
"priority": "SECONDARY",
"group": "<primary_connection_uuid>"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "<your_port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": <vlan_id>
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"type": "IA_PROFILE",
"uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6"
},
"location": {
"metroCode": "<metro_code>"
}
}
},
"project": {
"projectId": "<project_id>"
},
"order": {
"purchaseOrderNumber": "<purchase_order_number>"
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>"
]
}
]
}'
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​

Para solicitar seu serviço de acesso à Internet, envie uma POST solicitação para o /internetAccess/v2/services terminal.

Para redundância, se você criou duas conexões para seu serviço, defina type como DUALe forneça ambas as IDS de conexão ao connectionsarray. Se você criou uma conexão única para seu serviço, defina type como SINGLE e forneça o ID da conexão ao connectionsarray.

No routingProtocolobjeto, especifique:

  • Seu routingProtocol.type de STATIC, DIRECTou 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 addressingPlansinformações e questionsao ipBlockobjeto em caso de bloco IPv4 PA. Consulte a referência do API para obter mais informações.

Roteamento Estático​

A documentação sobre o roteamento estático pode ser encontrada aqui.

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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>,
"addressingPlans": [
{
"afterThreeMonths": <number_of_ip_addresses_used_after_three_months>,
"immediate": <number_of_ip_addresses_used_instantly>,
"purpose": "<purpose_of_ip_block>",
"size": <number_of_ip_addresses_requested>
}
],
"questions": [
{
"answer": "YES",
"type": "PRIVATE_SPACE_CONSIDERED"
},
{
"answer": "NO",
"type": "REFUSED_PREVIOUSLY"
},
{
"answer": "NO",
"type": "RETURNING_ADDRESS_SPACE"
}
]
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'

Roteamento direto​

A documentação sobre o roteamento direto pode ser encontrada aqui.

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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'

Roteamento BGP​

Especifique os detalhes da configuração do BGP no routingProtocolobjeto:

  • Quais rotas você deseja anunciar para a Internet, FULL, DEFAULT, FULL_DEFAULTou 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 emroutingProtocol.bgpAuthKey, se necessário.

A documentação sobre roteamento BGP pode ser encontrada aqui.

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 <token>' \
-d '{
"name": "My Internet Access Service",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'

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​

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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'

Roteamento direto​

Especifique quais IPs do seu bloco IP podem ser usados para fins de peering no peeringobjeto. Para o tipo de serviço único, forneça apenas um endereço IP no equinixPeerIpsarray. Para o tipo de serviço Duplo, forneça dois endereços IP no equinixPeerIpsarray 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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>"
]
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>"
]
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>",
"<peering_ip_address>"
],
"equinixVRRPIp": "<virtual_router_group_ip_address>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>",
"<peering_ip_address>"
],
"equinixVRRPIp": "<virtual_router_group_ip_address>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'

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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'

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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
},
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
},
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'

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} terminal.

Para ver os detalhes do seu serviço de acesso à Internet, use o internetAccess/v2/services/{serviceId} 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.

Esta página foi útil?