Conexões virtuais de tecido faturadas

As Conexões Virtuais de Fabric Fabric são usadas para estabelecer uma conexão entre suas portas de Fabric ou dispositivos Network Edge e o Equinix Metal, seja na mesma área metropolitana ou entre áreas metropolitanas . Os casos de uso incluem o uso de um dispositivo Network Edge como roteador para seus serviços Equinix Metal ou a conexão do Equinix Metal a um provedor de serviço de nuvem em diferentes áreas metropolitanas. Todas as cobranças por uso, Network Edge e dispositivo virtuais serão exibidas na sua conta Equinix Fabric .

Observação: este recurso substitui as Portas Compartilhadas para usuários anteriores de dispositivos Equinix Fabric e Network Edge com sua infraestrutura Equinix Metal . As interconexões de Porta Compartilhadas existentes continuarão funcionando e serão indicadas no portal e na API como Legadas.

Informações do sistema

• Cada Conexão Virtual de Fabric pode ser uma única porta ou um conjunto de portas redundante . portas redundantes são recomendadas para um certo nível de alta disponibilidade. Com uma única porta, não há disponibilidade garantido.

• Cada Conexão Virtual de Fabric vem com um único Circuito Virtual para você conectar a uma VLAN ou VRF. Se você estiver usando portas redundante, cada porta terá um circuito virtual.

• A relação entre circuitos virtuais e VLANs é de 1:1. Você só pode conectar uma VLAN a um circuito virtual e um circuito virtual a uma VLAN. A mesma VLAN não pode ser conectada a dois ou mais circuitos virtuais. Consequentemente, se você estiver projetando para alta disponibilidade com portas primárias e secundárias, você de uma VLAN para cada uma e precisará ter roteamento entre VLANs ou algum outro reconhecimento de aplicativo de camada 3.

• Para roteamento, as Conexões Virtuais de Fabric podem usar Roteamento e Encaminhamento Virtual. Para obter mais informações, consulte a página VRF para Interconexões.

• As conexões virtuais de Fabric têm uma largura de banda máxima de 10 Gbps.

• O Fabric Virtual Connection suporte uma unidade de transmissão máxima (MTU) de até 9000 bytes e quadros Ethernet jumbo.

Origens e Destinos

Origin	Destination	Supported
Qualquer porta física no Fabric (não em um [Perfil de Serviço)	Fabric Faturado Fabric VC	Sim
Dispositivo Virtual Único ([não em um Perfil de Serviço)	Fabric Faturado Fabric VC	Sim
Dispositivo Virtual Clusterizado (Par HA de Network Edge )	VC de Fabric Fabric	Não
VC de Fabric com faturamento Metal	VC de Fabric com faturamento Fabric	Não

Solicitando uma conexão virtual de Fabric Fabric

Console

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 Fabric VC e selecione Fabric Faturado.

• Selecione o local para a nova conexão no menu suspenso. Você deve escolher a área metropolitana onde seus servidores Equinix Metal e VLANs estão localizados ou onde você planeja provisionamento los.
• Dê um nome à sua conexão.
• Escolha se você um conjunto de portas redundante . Você obtém uma porta primária e uma porta secundária, cada uma com um circuito virtual para conectar duas VLANs, você um certo nível de redundância e alta disponibilidade.
• A Velocidade Máxima de Interconexão está definida para o máximo padrão de 10 Gbps. Você selecionará a velocidade real da conexão ao você seu token de serviço no portal Fabric .

Em seguida, selecione se você está conectando suas portas a uma VLAN ou a uma VRF.

• Se você estiver usando apenas VLANs, selecione a (VLAN (s) que serão conectadas às suas portas. As VLANs precisam estar no mesmo projeto e local que o seu Fabric VC. Se você não tiver nenhuma VLAN elegível, você em + Criar uma VLAN para criá-las. A mesma VLAN não pode ser conectada a dois ou mais circuitos virtuais; portanto, se você estiver solicitando portas redundante, selecione uma VLAN para cada uma. Observação: Você não poderá atualizar ou alterar a VLAN depois que o Fabric VC for criado.

• Se você estiver usando VRF, selecione o VRF para suas portas. Há documentação adicional na página VRF para Interconexões.

Analise o resumo da sua solicitar. Clique em Enviar solicitação para receber seus tokens de serviço do lado Z.

Os tokens expiram em 7 dias. Você também deverá receber um e-mail com seus tokens e informações sobre a data de expiração. Na página Interconexões, sua nova solicitação de Conexão Virtual de Fabric será exibida na aba Solicitações Pendentes.

CLI

Para solicitar um Fabric VC faturado pelo Fabric na CLI, use o comando metal interconnections create.

metal interconnections create -p <project_id> -n <name> -m <metro> -r redundant -t shared -T z_side [--vlans <vlan_id>, <vlan_id> | --vrfs <vrf_uuid>, <vrf_uuid>]

Opções:

• -p, --project-id (required) - Your Project's UUID.
• -r, --redundancy - Select primary or redundant. If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• -T, --service-token-type (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to z_side.
• -t, --type (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• --vlan" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The vlan option is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• --vrfs - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The vrfs option is required if you are using VRFs. If you are using VLANs, this field is NOT required.

Nota: Use o campo "vlans" ou o campo "vrfs". Eles são mutuamente exclusivos e pelo menos um deles é obrigatório.

O envio da solicitar gera seus tokens de serviço do lado z. Os tokens são incluídos no objeto de resposta. Se você solicitou uma conexão redundante, você dois tokens.

API

Para solicitar uma conexão através da API, envie uma solicitar POST para o endpoint /projects/{project_id}/connections. Se você estiver associando VLANs a este Fabric VC, use o parâmetro "vlans" no corpo da solicitar . Se você usando VRF, use o parâmetro "vrfs" no corpo da solicitar .

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": "z_side",
    "redundancy": "redundant",
    "vlans": [ <integer>, <integer> ]  
}'

Parâmetros corporais:

• "name" (required) - The name of your new Fabric Virtual Connection.
• "description" (optional) - A user-friendly description for your Fabric Virtual Connection.
• "contact_email" - The preferred email used for communication and notifications about the Interconnection. Required when using a Project API key. Optional and defaults to your user email address when using a User API key.
• "metro" (required) - The metro where the Fabric Virtual Connection lives.
• "type" (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• "service_token_type" (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to z_side.
• "redundancy" (required) - Select "primary" or "redundant". If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• "vlans" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The "vlans" field is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• "vrfs" - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The "vrfs" field is required if you are using VRFs. If you are using VLANs, this field is NOT required.

Nota: Use o campo "vlans" ou o campo "vrfs". Eles são mutuamente exclusivos e pelo menos um deles é obrigatório.

O envio da solicitar gera seus tokens de serviço do lado Z. Os tokens são incluídos na resposta no objeto "service_tokens". Se você solicitou uma conexão redundante, você dois tokens.

"service_tokens": [ 
    {
    “id”: "ff0cf4dc-a897-426d-9621-14e5b985058f",
    “role”: "primary",
    “state”: "inactive",
        “max_allowed_speed”: 10000000000,
    “service_token_type”: "z_side",
    “expires_at”: "2019-09-30T20:22:20",
    }
],

Os tokens expiram em 7 dias. Você também deverá receber um e-mail com seus tokens de serviço e informações sobre a data de expiração. Você pode verificar sua solicitar e recuperar os tokens durante esse período enviando uma solicitar GET para o endpoint /connections/{connection_id}.

curl -X GET -H 'X-Auth-Token: $API_TOKEN' \
"https://api.equinix.com/metal/v1/connections/{connection_id}"

Resgatando o Token de Serviço do Lado Z

Para resgatar seu token, faça login no portal Equinix Fabric e, no menu suspenso Conexões, clique em Criar uma conexão.

Em Conexões frequentes, selecione o bloco Conectar usando um token de serviço e clique em Inserir um token de serviço.

Na caixa de diálogo, cole seu token no campo Inserir Token de Serviço e clique em Validar.

Verifique se os dados do token estão corretos e clique em Resgatar para resgatar seu token e concluir a configuração da sua conexão com o Fabric.

Conexões Legadas - Se você já utilizou Portas Compartilhadas no Equinix Metal, você ter usado o campo Token do Fabric para resgatar seu token e configurar sua conexão. Se você já possui conexões legadas, elas continuarão funcionando normalmente. Caso você tokens legados não resgatados, não será mais possível resgatá-los no Equinix Fabric. Você precisará solicitar novos tokens de serviço e seguir os novos passos para resgatá-los no Fabric.

Configurando a Origem

Agora você pode continuar configurando sua conexão no portal Fabric . Como você resgatou um token de serviço pré-configurado, o Equinix Metal será automaticamente definido como o destino da conexão e você escolherá a origem.

Primeiro, selecione o local de origem da conexão . Geralmente, é um dispositivo virtual, mas também pode ser uma das suas portas do Equinix Fabric . O dispositivo virtual ou a porta podem estar em qualquer área metropolitana.

Se você usando um dispositivo virtual, selecione o tipo de dispositivo e o tipo de conexão . Atualmente, dispositivos redundantes e clusters não são suportados.

Na página Detalhes da Conexão, dê um nome amigável à sua conexão virtual, especifique quais interfaces no dispositivo virtual usar para se conectar (se necessário) e especifique um número de Pedido de Compra, caso sua organização o exija para fins de cobrança . A VLAN do lado z é atribuída automaticamente pelo token de serviço e não precisa corresponder aos seus IDs de VLAN no Equinix Metal.

Em seguida, defina a velocidade da conexão. O Equinix Metal define a velocidade máxima para Conexões Virtuais do Fabric - Fabric Faturado em 10 Gbps. Escolha entre as opções de velocidade e preços do Fabric .

A última página é uma revisão, onde você pode analisar suas escolhas e voltar para fazer alterações. Quando você pronto para fazer o pedido, clique em Enviar Pedido. Isso inicia um processo de configuração de conexão entre o Fabric e o Equinix Metal em segundo plano, que pode levar até 10 minutos para ser concluído.

Se você recebeu dois tokens por uma conexão redundante, certifique-se de repetir o processo para resgatar o segundo token.

Se você recuperar os tokens, eles estão disponíveis na aba Solicitação de Interconexão. Clique em Gerenciar na interconexão para a qual você os tokens.

Gerenciando conexões virtuais do Fabric

Console

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, com o status Ativo.

• As conexões virtuais de Fabric Fabric têm o tipo Fabric Billed.
• As conexões virtuais de Fabric com cobrança Metal têm o tipo Cobrança Metálica.
• As interconexões configuradas como Portas Compartilhadas são indicadas com o tipo Legado.

Observe que as Portas dedicadas são gerenciadas no nível da organização; portanto, se houver alguma Portas dedicada em sua organização, ela também aparecerá na seção Portas Dedicadas.

Clicar no nome da interconexão leva você à 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.

Clicar em Porta Primária ou Porta Secundária exibe o status e a configuração da porta.

CLI

Liste todas as interconexões do seu projeto, incluindo as conexões virtuais de Fabric faturadas, com o comando metal interconnections get. Especifique o projeto com -p ou --project_id.

metal interconnections get -p <project_id>

Observação: Portas Dedicadas são gerenciadas no nível da organização e compartilhadas entre os Projetos da organização. Se houver Portas Dedicadas na sua organização, elas também aparecerão na resposta.

Obtenha os detalhes de uma Conexão Virtual de Fabric específica com o comando metal interconnections get, especificando a Conexão Virtual de Fabric por seu UUID e -i ou --connID.

metal interconnections get -i <fabric_vc_uuid>

Para atualizar uma Conexão Virtual de Fabric, use o comando metal interconnections update. O UUID da Conexão Virtual de Fabric é obrigatório. Todos os outros campos são opcionais, podendo ser atualizados independentemente.

metal interconnections update -i <fabric_vc_uuid> -n <name> -d <description> -r <redundant|primary> -e <e-mail> --tags="<tag1>,<tag2>"

Opções:

• -i, --id (required) - The UUID of the interconnection.
• -e, --contactEmail - Adds or updates the email contact for the Fabric Virtual Connection.
• -n, --name - Updates the name.
• -d, --description - Adds or updates the description.
• -r, --redundancy - Updating to primary will remove a secondary port, while updating to redundant will add a secondary port.
• -t, --tags - Adds or updates the tags.

API

Para listar todas as interconexões em um projeto, envie uma solicitar GET para o endpoint /organizations/{organization_id}/connections, filtrando a resposta para o seu projeto no caminho da solicitar.

Observação: Portas Dedicadas são gerenciadas no nível da organização e compartilhadas entre os Projetos da organização. Se houver Portas Dedicadas na sua organização, elas também aparecerão na resposta.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/organizations/{organization_id}/connections?project={project_id}

Para obter os detalhes de um Fabric Billed Fabric VC, envie uma solicitar GET para o endpoint /connections/{connection_id}, especificando o UUID no caminho da solicitar .

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}

Você pode usar essas informações para gerenciar e atualizar o Fabric Billed Fabric VC enviando uma solicitar PUT para o endpoint /connections/{connection_id}. Especifique o que você alterar 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/connections/{connection_id}" \
-d '{
    "contact_email": "<string>",
    "description": "<string>",
    "name": "<string>",
    "redundancy": "<string>",
    "tags": [
        "<string>"
    ]
}'

Parâmetros corporais:

• "contact_email" - Adds or updates the email contact for the Fabric Virtual Connection.
• "name" - Updates the name.
• "description" - Adds or updates the description.
• "redundancy" - Updating to "primary" will remove a secondary port, while updating to "redundant" will add a secondary port.
• "tags" - Adiciona ou atualiza as tags.

Você também pode obter informações de porta de suas interconexões.

Para obter uma lista das portas de um Fabric Billed Fabric VC, envie uma solicitar GET para o endpoint /connections/{connection_id}/ports.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports

E para obter os detalhes de uma das portas, envie uma solicitar GET para o endpoint /connections/{connection_id}/ports/{id}.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports/{id}

Circuitos Virtuais

Cada uma de suas portas, primária e secundária, tem um único circuito virtual ao qual uma VLAN ou VRF pode ser conectada.

Se você estiver usando VLANs, seus circuitos virtuais serão anexados às VLANs você . Eles não podem ser modificados ou alterados. Se você de um Fabric VC com uma VLAN diferente, você necessário desmontar e recriar o Fabric VC.

Observação: Se você adicionou, removeu ou alterou VLANs em um Circuito Virtual anteriormente por meio do console ou da API, essas opções não estarão disponíveis após 29 de fevereiro de 2024 As solicitações de atualização (PUT) para o endpoint /virtual-circuits/{id} terão um cabeçalho sunset em sua resposta. Há uma exceção apenas para VCs de Fabric provisionados antes de 1 de março de 2024 que estão Aguardando VLAN do cliente.

Se você estiver usando VRF, seus circuitos virtuais terão o status Aguardando detalhes de peering.

Configurando VRF

Console

Se você estiver usando VRF em seus circuitos virtuais, clique no menu de três barras para abrir o painel Gerenciar detalhes de peering. Preencha os campos com as informações solicitadas.

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.

Documentação mais detalhada está disponível na página VRF para Interconexões.

Clique em Atualizar Circuito Virtual.

Se você tiver portas redundante, repita esse processo na Porta Secundária.

API

Para atualizar seu Circuito Virtual com os detalhes de peering do 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.

Para sub-redes IPv4:

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

Para sub-redes 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>"
}'

Documentação mais detalhada está disponível na página VRF para Interconexões.

Excluindo uma conexão virtual do Fabric

aviso

A exclusão de uma conexão virtual do Fabric é permanente. Ao você a conexão, todas as VLANs conectadas serão desconectadas e o tráfego do Fabric para seus servidores será cortado.

Excluir uma conexão virtual faturada pelo Fabric no Equinix Metal exclui automaticamente a conexão no Fabric. Se você excluí-la do portal do Fabric, ela também será limpa automaticamente no Equinix Metal . Este é um processo assíncrono que pode levar até 3 minutos para ser concluído.

Certifique-se de interromper o tráfego antes da exclusão e de você todos os recursos associados à conexão. Fazer isso antes de excluir a conexão do portal Metal ou Fabric garante que a conexão seja totalmente excluída e as cobranças de cobrança interrompidas.

Console

Na lista de conexões da página Interconexões, clique no nome da Conexão Virtual de Fabric que deseja excluir.

Clique em Excluir interconexão para excluir permanentemente a conexão virtual da Fabric .

CLI

Para excluir uma Conexão Virtual de Fabric, use o comando metal interconnections delete. Especifique o UUID da Conexão Virtual de Fabric com -i ou --id. Para ignorar a etapa de confirmação, use -f ou --force.

metal interconnections delete -i <uuid> -f

API

Para excluir uma Conexão Virtual do Fabric da API, envie uma solicitar DELETE para o endpoint /connections/{connection_id}, especificando o ID da porta no caminho.

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{id}

O envio da solicitar excluirá a conexão permanentemente.