Usando VRF com interconexões
O Equinix Metal ™ Virtual Routing and Forwarding (VRF) fornece um roteador virtual para conectividade de rede de Camada 3 entre uma rede privada de Camada 2 do Metal Gateway e destinos remotos no Fabric ou em um Equinix IBX. O VRF é compatível com Virtual VCs do Fabric faturados pelo Metal, Virtual VCs do Fabric faturados pelo Fabric e Portas Dedicadas.
Para usar VRFs com suas interconexões, você primeiro precisará provisionar seus VRFs, Metal Gateways e reservas de IP conforme descrito na documentação do VRF.
Solicitando um Fabric VC com VRF
Para usar VRF com um Fabric VC, você precisa solicitar o Fabric VC após criar o seu VRF. Não é possível associar um VRF a um Fabric VC existente.
O processo para solicitar um Fabric VC com cobrança de metal ou com cobrança de tecido é semelhante ao de solicitar um não-VRF.
- Console
- API
Para solicitar uma Conexão Virtual de Fabric, abra a página Interconexões do projeto. Clique em + Solicitar Nova Interconexão. Na seção Tipo de Interconexão, clique no menu suspenso em Conexão Virtual de Tecido e selecione Cobrança por Metal ou Cobrança por Tecido.

- Selecione o local para a nova conexão no menu suspenso. Selecione a área metropolitana onde está localizada sua infraestrutura Equinix Metal e a área metropolitana onde está o CSP ao qual você está se conectando no Fabric: essas interconexões são vinculadas à área metropolitana.
- Dê um nome à sua conexão.
- Escolha se você um conjunto de portas redundante . portas redundantes são altamente recomendadas. Selecionar uma única porta pode resultar em tempo de inatividade significativo devido a interrupções planejadas e não planejadas.
- Defina a velocidade da conexão selecionando-a no menu suspenso. Observação: a velocidade não pode ser alterada após a emissão de um token de serviço. Uma nova solicitar e um novo token de serviço são necessários para alterar a velocidade.
Em seguida, selecione VRF para associar seu Roteador Virtual ao Fabric VC. Se você escolher portas redundante, haverá um menu suspenso para selecionar um Roteador Virtual para as portas Primária e Secundária.

Analise o resumo da sua solicitar. Clique em Enviar Solicitação para receber seus tokens de serviço. Em seguida, conclua o processo de resgate do seu token de serviço e configuração da conexão no portal Fabric .
Assim que a interconexão entre o Fabric e o Equinix Metal for estabelecida, ela aparecerá na página Interconexões do seu projeto, na seção Fabric VC. Clique no Fabric VC para visualizar a página Visão geral, que contém uma visão detalhada, bem como um resumo das configurações da porta primária e da porta secundária.
Clicar em Porta Primária ou Porta Secundária exibe o status e a configuração da porta. Seu VRF é listado na seção Circuitos Virtuais - VRF da página da porta com o status _aguardando detalhes de peering .

Clique no menu de três barras para abrir o painel Gerenciar Detalhes de Emparelhamento. É aqui que você especifica a sub-rede do intervalo de endereços IP do VRF que será usada para endereçar o VRF e o lado remoto do circuito virtual. A reserva de endereço IP para essa sub-rede será criada automaticamente.

Preencha os campos com as informações solicitadas.
- ASN do par (obrigatório) - O ASN que será usado com o VRF e o lado remoto da conexão no circuito virtual.
- Sub-rede (obrigatório)
- Para sub-redes IPv4, a sub-rede
/30ou/31de um dos blocos IP do VRF é usada para endereçar o VRF e o lado remoto do circuito virtual. O Metal IP e o Customer IP são endereços IP dessa sub-rede que você pode especificar opcionalmente. Se não forem especificados, o Metal IP será o último endereço IP utilizável na sub-rede e o Customer IP será o primeiro endereço IP utilizável na sub-rede. Para sub-redes/30, os endereços IP de rede e de broadcast não podem ser usados como Metal IP ou Customer IP. - Para sub-redes IPv6, a sub-rede
/126ou/127de um dos blocos IP do VRF é usada para endereçar o VRF e o lado remoto do circuito virtual. O Metal IP e o Customer IP são endereços IP dessa sub-rede que você pode especificar opcionalmente. Se não forem especificados, o Metal IP será o último endereço IP utilizável na sub-rede e o Customer IP será o primeiro endereço IP utilizável na sub-rede. Para sub-redes/126, os endereços IP de rede e de broadcast não podem ser usados como Metal IP ou Customer IP.
- Para sub-redes IPv4, a sub-rede
- Senha MD5 (opcional) - Defina uma senha MD5 opcional em texto simples para o peering BGP .
Clique em Atualizar Circuito Virtual.
Se você tiver portas redundante, repita esse processo na Porta Secundária.
Envie uma solicitar POST para o endpoint /projects/{project_id}/connections e especifique o VRF (ou VRFs para VCs redundante ) com o objeto "vrfs".
Lembre-se de que o Fabric VC deve estar no mesmo área metropolitana que o VRF.
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{project_id}/connections" \
-d '{
"name": "<string>",
"description": "<string>",
"contact_email": "<string>",
"metro": "<metro_slug>",
"type": "shared",
"service_token_type": "<string>",
"redundancy": "redundant",
"speed": "<string>",
"vrfs": ["<UUID>", "<UUID>"]
}'
Parâmetros corporais a serem observados para VRF:
"vrfs"(required) - Array of VRF IDs that will be set automatically on the virtual circuits on creation, and can hold up to two UUIDs. Two IDs are required when requesting redundant Fabric VCs. The first ID will be set on the primary virtual circuit, while the second UUID will be set on the secondary. The two IDs can be the same if both the primary and secondary virtual circuits will be in the same VRF.
Você deve então concluir o processo para resgatar seu token de serviço e configurar a conexão no portal Fabric .
Assim que seu Fabric VC estiver sendo exibido como Ativo e estiver _aguardando detalhes de peering, você poderá atualizá-lo com os detalhes de peering para seu VRF. Envie uma solicitar PUT para o endpoint /virtual-circuits/{vrf_virtual_circuit_id}.
Aqui você especifica a sub-rede do intervalo de endereços IP da VRF que será usada para endereçar a VRF e o lado remoto do circuito virtual. A reserva de endereço IP para esta sub-rede será criada automaticamente.
Se você estiver usando sub-redes IPv4, use os parâmetros de corpo "subnet", "metal_ip" e "customer_ip".
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
"peer_asn": <integer>,
"subnet": "<subnet>",
"metal_ip": "<ip_address>",
"customer_ip": "<ip_address>”,
"md5": "<string>"
}'
Parâmetros corporais:
"peer_asn"- The peer ASN that will be used with the VRF on the Virtual Circuit."subnet"- The/30or/31subnet of one of the VRF IP Blocks that will be used with the VRF for the Virtual Circuit. Themetal_ipandcustomer_ipmust be IP addresses from this subnet. For/30subnets, the network and broadcast IP addresses cannot be used as themetal_iporcustomer_ip."customer_ip"(optional) - An IP address from the subnet that will be used on the remote side of the connection. This parameter is optional, but if supplied, we will use the other usable IP address in the subnet as themetal_ip. By default, the last usable IP address in the subnet will be used."metal_ip"(optional) - An IP address from the subnet that will be used for the VRF on the Metal side. This parameter is optional, but if supplied, we will use the other usable IP address in the subnet as thecustomer_ip. By default, the first usable IP address in the subnet will be used."md5"- Optional string or null MD5 password for the BGP peering in plaintext.
Se você estiver usando sub-redes IPv6, use os parâmetros de corpo "subnet_ipv6", "metal_ipv6" e "customer_ipv6".
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
"peer_asn": <integer>,
"subnet_ipv6": "<subnet>",
"metal_ipv6": "<ip_address>",
"customer_ipv6": "<ip_address>”,
"md5": "<string>"
}'
Parâmetros corporais:
"peer_asn"- The peer ASN that will be used with the VRF on the Virtual Circuit."subnet"- The/126or/127IPv6 subnet from a VRF IP Block that will be used with the VRF for the Virtual Circuit. Themetal_ipv6andcustomer_ipv6must be IP addresses from this subnet. For/126subnets, the network and broadcast IP addresses cannot be used as themetal_ipv6orcustomer_ipv6."customer_ipv6"(optional) - An IP address from the subnet that will be used on the remote side of the connection. This parameter is optional, but if supplied, we will use the other usable IP address in the subnet as themetal_ipv6. By default, the last usable IP address in the subnet will be used."metal_ipv6"(optional) - An IP address from the subnet that will be used for the VRF on the Metal side. This parameter is optional, but if supplied, we will use the other usable IP address in the subnet as thecustomer_ipv6. By default, the first usable IP address in the subnet will be used."md5"- Optional string or null MD5 password for the BGP peering in plaintext.
Uma lista completa dos componentes atualizáveis para um circuito virtual está disponível na Referência da API .
Para verificar o status e os detalhes de peering do seu Fabric VC, envie uma solicitar GET para o endpoint /connections/{id}.
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/connections/{id}
Usando VRF com Portas dedicadas
Observação: VRF não é compatível com o modo Túnel Dedicado.
O VRF está disponível em Portas dedicadas novas e existentes. Portanto, se ainda você o fez, você pode solicitar uma nova Porta dedicada, obter uma LOA e, assim que você a confirmação de que a pedido de serviço para configurar sua porta foi concluída, você criar circuitos virtuais com VRF.
Se você já tiver uma Porta Dedicada, você criar um novo Circuito Virtual em uma Porta Dedicada existente com VRF.
- Console
- API
Ao clicar em uma Porta Dedicada, você será direcionado para a página Visão Geral, que contém uma visualização detalhada, bem como um resumo das configurações da porta primária e da porta secundária. Uma visualização detalhada das portas está disponível clicando nas abas Porta Primária e Porta Secundária.

Na guia Porta Primária, clique em +Adicionar Circuito Virtual para criar um circuito virtual ao qual conectar seu VRF. No painel Adicionar Circuito Virtual, primeiro dê um nome a ele e especifique o ID da VLAN NNI. Lembre-se: se você estiver se conectando a um destino na Fabric, a VLAN NNI deve corresponder à da Fabric .
Em seguida, selecione VRF.

Selecione o VRF no menu suspenso para anexar a esta Conexão Virtual e preencha as informações de peering solicitadas.
- ASN do par (obrigatório) - O ASN que será usado com o VRF e o lado remoto da conexão no circuito virtual.
- Sub-rede (obrigatório)
- Para sub-redes IPv4, a sub-rede
/30ou/31de um dos blocos IP do VRF é usada para endereçar o VRF e o lado remoto do circuito virtual. O Metal IP e o Customer IP são endereços IP dessa sub-rede que você pode especificar opcionalmente. Se não forem especificados, o Metal IP será o último endereço IP utilizável na sub-rede e o Customer IP será o primeiro endereço IP utilizável na sub-rede. Para sub-redes/30, os endereços IP de rede e de broadcast não podem ser usados como Metal IP ou Customer IP. - Para sub-redes IPv6, a sub-rede
/126ou/127de um dos blocos IP do VRF é usada para endereçar o VRF e o lado remoto do circuito virtual. O Metal IP e o Customer IP são endereços IP dessa sub-rede que você pode especificar opcionalmente. Se não forem especificados, o Metal IP será o último endereço IP utilizável na sub-rede e o Customer IP será o primeiro endereço IP utilizável na sub-rede. Para sub-redes/126, os endereços IP de rede e de broadcast não podem ser usados como Metal IP ou Customer IP.
- Para sub-redes IPv4, a sub-rede
- Senha MD5 (opcional) - Defina uma senha MD5 opcional em texto simples para o peering BGP .
Clique em Adicionar circuito virtual.
Se você tiver portas redundante, repita esse processo na Porta Secundária.
Para criar um novo Circuito Virtual com o VRF, envie uma solicitar POST para o endpoint /connections/{connection_id}/ports/{port_id}/virtual-circuits, especificando o VRF no corpo da solicitar.
É aqui que você especifica as informações de peering — a sub-rede do intervalo de endereços IP da VRF que será usada para endereçar a VRF e o lado remoto do circuito virtual. A reserva de endereço IP para esta sub-rede será criada automaticamente.
Se você estiver usando sub-redes IPv4, use os parâmetros de corpo "subnet", "metal_ip" e "customer_ip".
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/connections/{connection_id}/ports/{port_id}/virtual-circuits" \
-d '{
"project_id": "<UUID>",
"name": "<string>",
"description": "<string>",
"subnet": "<subnet>",
"customer_ip": "<ip_address>",
"metal_ip": "<ip_address>",
"nni_vlan": <integer>,
"peer_asn": <integer>,
"md5": "<string>",
"vrf": "<UUID>"
}'
Parâmetros corporais:
"project_id"(required) - The Project ID where the Dedicated Port and this Virtual Circuit lives."name"- A name for this Virtual Circuit."description"- An optional friendly description of the Virtual Circuit."subnet"(required) - A/30or/31subnet from a VRF IP address range that will be used with the VRF for the Virtual Circuit. If specified,metal_ipandcustomer_ipmust be from this subnet. For/30subnets, the network and broadcast IPs cannot be used as themetal_iporcustomer_ip. The subnet specified must be contained within an already-defined IP Range for the VRF."customer_ip"(optional) - An IP address from the subnet that will be used on the remote side of the connection. This parameter is optional, but if supplied, we will use the other usable IP address in the subnet as the Metal IP. By default, the last usable IP address in the subnet will be used."metal_ip"(optional) - An IP address from the subnet that will be used for the VRF on the Metal side. This parameter is optional, but if supplied, we will use the other usable IP address in the subnet as the Customer IP. By default, the first usable IP address in the subnet will be used."nni_vlan"(required) - [ 2 .. 4094 ]. Remember if you are connecting to a destination on Fabric the NNI VLAN has to match the Fabric side."peer_asn"(required) - integer - The peer ASN that will be used with the VRF on the Virtual Circuit."md5"- Optional string or null MD5 password for the BGP peering in plaintext."vrf"(required) - The UUID of the VRF that will be associated with the Virtual Circuit.
Se você estiver usando sub-redes IPv6, use os parâmetros de corpo "subnet_ipv6", "metal_ipv6" e "customer_ipv6".
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/connections/{connection_id}/ports/{port_id}/virtual-circuits" \
-d '{
"project_id": "<UUID>",
"name": "<string>",
"description": "<string>",
"subnet_ipv6": "<subnet>",
"customer_ipv6": "<ip_address>",
"metal_ipv6": "<ip_address>",
"nni_vlan": <integer>,
"peer_asn": <integer>,
"md5": "<string>",
"vrf": "<UUID>"
}'
Parâmetros corporais:
"project_id"(required) - The Project ID where the Dedicated Port and this Virtual Circuit lives."name"- A name for this Virtual Circuit."description"- An optional friendly description of the Virtual Circuit."subnet"- The/126or/127IPv6 subnet from a VRF IP Block that will be used with the VRF for the Virtual Circuit. Themetal_ipv6andcustomer_ipv6must be IP addresses from this subnet. For/126subnets, the network and broadcast IP addresses cannot be used as themetal_ipv6orcustomer_ipv6."customer_ipv6"(optional) - An IP address from the subnet that will be used on the remote side of the connection. This parameter is optional, but if supplied, we will use the other usable IP address in the subnet as themetal_ipv6. By default, the last usable IP address in the subnet will be used."metal_ipv6"(optional) - An IP address from the subnet that will be used for the VRF on the Metal side. This parameter is optional, but if supplied, we will use the other usable IP address in the subnet as thecustomer_ipv6. By default, the first usable IP address in the subnet will be used."nni_vlan"(required) - [ 2 .. 4094 ]. Remember if you are connecting to a destination on Fabric the NNI VLAN has to match the Fabric side."peer_asn"(required) - integer - The peer ASN that will be used with the VRF on the Virtual Circuit."md5"- Optional string or null MD5 password for the BGP peering in plaintext."vrf"(required) - The UUID of the VRF that will be associated with the Virtual Circuit.
Uma lista completa dos componentes para um circuito virtual está disponível na Referência da API .
Diferentemente de quando você cria um circuito virtual que não está associado a VRFs, você não precisa voltar para associar uma rede virtual ao circuito virtual; aquela conectada ao Metal Gateway do VRF será associada automaticamente.
Assim que a configuração do VC estiver completa, o estado do circuito virtual muda para Active.
Gerenciando VRF em uma interconexão
- Console
- API
Você pode gerenciar os detalhes de peering de uma VRF em um Fabric VC ou em um Dedicated Porta VC nas abas Primary Port ou Secondary Port do VC. As VRFs são listadas na seção Virtual Circuits - VRF. Clique no menu de três barras para abrir o painel Manage Peering Details.

Preencha os campos com as novas informações de peering e clique em Atualizar Circuito Virtual.
Para atualizar os detalhes de peering de uma VRF em um Fabric VC ou em um Dedicated Porta VC, envie uma solicitar PUT para o endpoint /virtual-circuits/{id}. Use os campos que você deseja atualizar no corpo da solicitar. Todos os campos são opcionais, portanto, podem ser atualizados independentemente.
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{id}" \
-d '{
"name": "<string>",
"description": "<string>",
"subnet": "<subnet>",
"customer_ip": "<ip_address>",
"metal_ip": "<ip_address>",
"peer_asn": <integer>,
"md5": "<string>"
}'