Endereços IP Anycast globais

Os IPs Anycast globais da Equinix Metal™ são endereços IPv4 públicos extraídos do espaço IP de propriedade da Equinix Metal e que podem ser anunciados de qualquer ou de todos os Metros da Equinix Metal.

Endereços IP Anycast globais podem ser usados:

• atribuindo-os como um endereço IP elástico a um único servidor em várias Metros.
• OU anunciando-os via BGP local de vários servidores em várias Metros.

Se um endereço IP Global Anycast não for roteado ou anunciado de nenhum servidor em nenhuma área metropolitana, o endereço IP ficará inacessível.

O Equinix Metal permite que você reserve os seguintes tamanhos de sub-rede de endereços IP Global Anycast.

Global Anycast Subnet Size	Usable IP Addresses
/32	1 IPv4 address
/31	2 IPv4 addresses
/30	4 IPv4 addresses

Os endereços IP Anycast globais são cobrados com base no uso, a uma taxa fixa por IP por hora. A largura de banda é cobrada com base na taxa padrão de saída e na taxa de entrada por GB. As tarifas estão disponíveis no console Equinix Metal .

Solicitando endereços IP globais Anycast

Console

Na seção Rede do seu projeto, abra a página IPs.

Os endereços IP atuais do seu projeto devem ser listados. Para solicitar endereços IP Anycast globais, clique em + Adicionar novo.

Na aba Solicitar Endereços IP, selecione IPv4 Global e a Quantidade (tamanho) da sub-rede reservada. Há também campos para Tags e Descrição para sua utilização. O campo JSON Personalizado é para dados personalizados que você deseja incluir nos metadados do seu servidor.

Utilize o campo Comentários para entrar em contato com o suporte e fornecer informações relevantes à sua solicitar. Observe que, caso você solicitar várias sub-redes ou várias sub-redes grandes, existem cotas definidas no nível do projeto. A equipe de suporte poderá alcance em contato para esclarecer dúvidas sobre a sua solicitar.

CLI

Para solicitar um endereço IP Anycast Global, use o comando metal ip request e especifique --type como global_ipv4.

metal ip request --project-id <project_id> --type global_ipv4 --quantity <int>

API

Para solicitar endereços IP adicionais na API, envie uma solicitar POST para o endpoint /projects/{id}/ips.

curl -X POST \
-H 'Content-Type: application/json' \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/ips" \
-d '{
    "type": "global_ipv4",
    "quantity": 4,
    "fail_on_approval_required": "false"
}'

Parâmetros Corporais

• "type" (required) - To request a Global Anycast IP address, use "global_ipv4".
• "quantity" (required) - The quantity parameter should be the number of IPs in the subnet. Valid values are 1, 2, and 4 for Global Anycast IP addresses.
• "fail_on_approval_required" (optional) - If you submit a request that exceeds the maximum number of IP addresses available to your project, you can automatically have the request fail with HTTP status 422 instead of triggering the review process by providing the fail_on_approval_required parameter set to true in the request.

Uma lista completa dos campos e opções dos parâmetros do corpo está disponível na referência da API .

Gerenciando endereços IP Anycast globais

Console

A página IPs do seu projeto contém uma lista de todas as sub-redes e IPs de gerenciamento, reservadas e Anycast globais.

CLI

Na CLI, todas as informações de gerenciamento, reservadas e de sub-redes Anycast globais e endereços IP para um projeto estão disponíveis no comando metal ip get.

`metal ip get -p <project-uuid>`

API

Para obter uma lista das sub-redes e IPs de gerenciamento, reservadas e globais Anycast em seu projeto, envie uma solicitar GET para o endpoint /projects/{id}/ips.

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/ips"

A resposta contém um ID de reserva no campo "id". (A resposta de exemplo está truncada.)

{
"ip_addresses": [
    {
    "id": "804c4112-c00a-486c-9c54-0918dd1894b2",
    "address_family": 4,
    "netmask": "255.255.255.254",
    "created_at": "2022-09-21T13:14:55Z",
    "public": true,
    "cidr": 31,
    "management": false,
    "manageable": true,
    "enabled": true,
    "global_ip": true,
    "assignments": [],
    "network": "147....",
    "address": "147....",
    "gateway": "147....",
    "type": "global_ipv4"
    ....
    },
    ....
]
}

Anunciando seu endereço IP

Depois de você ter sido atribuído o seu bloco de endereços IPv4 Anycast globais, você duas opções: atribuir os seus novos endereços IP a um servidor como IPs Elásticos, ou anunciá-los com BGP.

Se você optar por vincular endereços IP globais Anycast como um endereço IP elástico, você atribuir endereços individuais a um único servidor em cada área metropolitana. No entanto, se você atribuir o mesmo endereço IP a mais de um servidor no mesmo área metropolitana, você um erro.

Se você por anunciar seus IPs Anycast globais com BGP, você precisará configurar o BGP local. Você pode usar o BGP para atribuir seu endereço IP Anycast global a vários servidores em cada área metropolitana, por isso recomendamos o uso do BGP para aplicativos de alta disponibilidade.

Status global do IP Anycast

Console

Para verificar o status do seu bloco de IP Anycast Global, acesse a página IPs do seu projeto e abra o menu Ações da reserva de IP que deseja gerenciar. Clique em Atualizar Bloco.

Um círculo cinza indica que um IP no bloco não está atribuído na instalação ou não está sendo anunciado via BGP. Um círculo verde indica que um IP no bloco está atribuído ou não está sendo anunciado nessa instalação. Se você não anunciar ou vincular um IP Global Anycast em uma instalação, faremos o backhaul desse tráfego para a instalação mais próxima onde o IP estiver atribuído ou anunciado. Isso gera custos, e é por isso que há uma cobrança pela transferência de entrada.

CLI

Para verificar as sub-redes e endereços IP disponíveis no seu bloco IP Anycast Global, use o comando metal ip available. O --reservation-id pode ser obtido a partir do comando metal ip get -p <project-uuid>.

metal ip available --reservation-id <reservation_UUID> --cidr <size_of_subnet>

API

Você pode verificar o status das sub-redes e endereços IP em cada uma das sub-redes de Gerenciamento, Reservadas e Anycast Global do seu projeto enviando uma solicitar GET para o endpoint /ips/{id}. O UUID de reserva da sub-rede ou endereço IP deve ser incluído no caminho.

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"

A resposta inclui o ID de reserva do bloco de endereços IP no objeto "assignments". (A resposta de exemplo está truncada.)

{
"ip_addresses": [
    {
    "id": "804c4112-c00a-486c-9c54-0918dd1894b2",
    "address_family": 4,
    "netmask": "255.255.255.254",
    "global_ip": true,
        "assignments": [
        {
            "href": "/metal/v1/ips/4cc7f67b-522e-4b6c-82a5-3b2505cf326a"
        }
        ],
    ....
    "type": "global_ipv4"
    },
    ....
]
}

Excluindo uma reserva de IP Anycast global

Excluir uma reserva remove a sub-rede do seu projeto. Você não poderá mais usar os endereços IP dos seus servidores.

Console

Para excluir uma reserva, acesse a página IPs do seu projeto e selecione o bloco de IP Anycast Global. Clique em Excluir.

CLI

Para remover uma reserva de IP Anycast Global, use o comando metal ip remove.

metal ip remove --id <reservation-id>

API

Para excluir uma reserva de IP através da API, envie uma solicitar DELETE para o endpoint /ips/{id}. O id é o UUID da reserva.

curl -X DELETE \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"