Pedido acesso à Internet com a Network Edge

O Equinix Internet Access (EIA) oferece acesso à internet híbrido, utilizando múltiplos provedores de serviços de internet (ISPs) de nível 1 e Pontos de Troca de Internet (IXs) da Equinix para fornecer alta disponibilidade, confiabilidade e velocidade. Para solicitar acesso à internet por meio da API:

• A conexão de rede entre o seu dispositivo Network Edge e o perfil de serviço Equinix Internet Access é fornecida gratuitamente.
• Quando você desprovisiona 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 Internet Access, a conexão Fabric associada será desprovisionada automaticamente.

O Equinix Internet Access com Network Edge está disponível para organizações integradas ao Equinix Identity and Access Management, e a conta usada para enviar solicitações de API deve ter as funções Equinix Fabric Manager, Network Edge Connections Manager e Network Edge Device Manager.

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.

2. Determine as informações do lado A. Você precisa de um Dispositivo Virtual de Borda de Rede (Network Edge Virtual Device), Dispositivos Redundantes ou Cluster provisionados com uma licença registrada. Envie uma solicitação GET para o endpoint /ne/v1/devices ou para o endpoint /ne/v1/devices/{id}. Você pode escolher qualquer interface disponível no dispositivo para sua conexão. No entanto, a Equinix selecionará uma interface caso você não especifique nenhuma.

3. Determine as informações do lado Z. O perfil do 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 solicitação GET para o endpoint /internetAccess/v2/ibxs 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 o seu serviço de Acesso à Internet, envie uma solicitação POST para o endpoint /fabric/v4/connections. O tipo de conexão é IA_VC.

Forneça as informações do seu dispositivo virtual no objeto aSide, incluindo:

• accessPoint.type as VD
• virtualDevice.type como EDGE
• virtualDevice.uuid como o UUID do seu dispositivo

Forneça o perfil do serviço de acesso à Internet no objeto zSide, incluindo:

• accessPoint.type as SP.
• profile.type como IA_PROFILE
• profile.uuid como 32d81829-0bf8-45d5-84e2-7289a553dbb6
• metroCode é o código de duas letras da área metropolitana de Internet Access à qual você está se conectando.

Se você estiver criando conexões redundantes, faça duas solicitações. Uma das solicitações deve ter o parâmetro redundancy.priority definido como PRIMARY. e a outra redundancy.priority definida como SECONDARY e você deve especificar redundancy.group como o UUID da primeira conexão. Utilize um cluster de dispositivos virtuais ou um par de dispositivos redundantes (um para primário e outro para secundário) para o lado A.

Exemplos de requisições cURL:

Primary connection example

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": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<your_virtual_device_uuid>"
      }
    }
  },
  "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>"
      ]
    }
  ]
}'

Secondary connection example

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": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<your_virtual_device_uuid>"
      }
    }
  },
  "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ê precisa desse UUID de conexão para solicitar o serviço de acesso à Internet.

Serviço de Pedindo com bloco de IP atribuído pelo fornecedor

observação

Se você estiver usando conexões redundantes para dispositivos redundantes ou um cluster, somente o roteamento BGP será suportado.

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

Ao solicitar seu serviço usando endereços IP de propriedade da Equinix (PA), defina o valor de ipBlock.prefixLength para o tamanho da sub-rede que você precisa.

Se você estiver solicitando o serviço por meio de uma única conexão:

• Defina type como SINGLE e forneça o ID da conexão para a matriz connections.
• Escolha o seu routingProtocol.type entre STATIC, DIRECT ou BGP.

Se você estiver solicitando serviço através de um par de conexões redundantes:

• Defina type como DUAL e forneça os dois IDs de conexão para a matriz connections.
• Defina seu routingProtocol.type como BGP.

observação

Ao solicitar uma instância do serviço EIA localizada em um de nossos data centers IBX na região da Ásia-Pacífico, certifique-se de adicionar as informações addressingPlans e questions ao objeto ipBlock no caso de um bloco IPv4 PA. Consulte a referência da 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:

Single Static Service in APAC region example

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

Roteamento direto

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

Exemplos de requisições cURL:

Single Direct Service example

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

Roteamento BGP

Especifique os detalhes da sua configuração BGP no objeto routingProtocol:

• Em routingProtocol.exportPolicy, você define quais rotas deseja anunciar para a Internet: FULL, DEFAULT, FULL_DEFAULT ou PARTIAL.
• 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 a chave de autenticação BGP em routingProtocol.bgpAuthKey, se necessário.

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

Exemplos de requisições cURL:

Single BGP Service example

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": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv4_ip_block>
          }
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv6_ip_block>
          }
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'

Dual BGP Service example

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 Pedindo com bloqueio de IP independente do provedor

Ao solicitar seu serviço usando seu próprio bloco de IP (PI), especifique-o em customerRoutes.prefix.

Roteamento estático

Exemplos de requisições cURL:

Single Static Service example

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

Roteamento direto

Especifique quais IPs do seu bloco de IPs podem ser usados ​​para fins de peering no objeto peering. Para o tipo de serviço único, forneça apenas um endereço IP na matriz equinixPeerIps.

Exemplos de requisições cURL:

Single Direct Service example

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

Roteamento BGP

Exemplos de requisições cURL:

Single BGP Service example

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

Dual BGP Service example

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 Pedindo com blocos IP PA e PI

Ao pedindo seu serviço com blocos de IP atribuídos 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 de IP fornecido pela Equinix (PA).
• customerRoutes.prefix caso utilize seu próprio bloco de 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:

Provider Assigned and Provider Independent IP Blocks example

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 visualizar o status da sua solicitação de criação de conexão, envie uma solicitação GET para o endpoint fabric/v4/connections/{connectionId}.

Para visualizar os detalhes do seu serviço de acesso à Internet, use o endpoint internetAccess/v2/services/{serviceId}.

Caso ocorra algum problema com o provisionamento da sua instância de serviço de Acesso à Internet, a conexão associada será desprovisionada automaticamente.