Sobre IPs Reservados

A capacidade de IPs reservados no VPC permite que você reserve endereços IP para uso em seus recursos. É possível especificar um endereço particular ou permitir que o sistema selecione qualquer endereço disponível. Também é possível fazer uma nova reserva de IP com ou sem um destino com o qual ligar o endereço.

Antes de Iniciar

Os IPs reservados são sub-redes de sub-recurso. O Identity and Access Management (IAM) não tem, atualmente, suporte para sub-recursos, portanto, os IPs reservados "herdam" permissões da sub-rede.

Para ver as permissões do IAM necessárias para IPs reservados, consulte Chamadas de sub-redes.

O VPC não suporta pacotes de IP fragmentados. Pacotes fragmentados são descartados na borda.

Problemas conhecidos do IP reservado

Os problemas a seguir se aplicam a IPs reservados. Esses problemas serão resolvidos em versões futuras.

Problema: Endereços IP reservados vinculados a gateways de VPN, nós de trabalho do IKS ou instâncias do serviço DNS aparecerão como se não tivessem destino (a propriedade target não é incluída ao recuperar o recurso de IP reservado).

Como resultado, esses endereços IP reservados podem parecer não estar vinculados a nenhum dispositivo. Apesar de parecerem não estar associados, esses endereços IP reservados não podem ser excluídos até que o recurso ao qual se referem seja excluído.

No console, endereços IP reservados marcados como “unbound” podem estar vinculados a um recurso que não pode ser exibido.

Problema: Atualmente, a API de metadados não oferece suporte a endereços IP reservados.

Solução alternativa: Continuar a usar a propriedade primary_ipv4_address para recuperar o endereço IP para cada interface de rede em uma instância. Veja a API de metadados do VPC.

Problema: Ao usar a API do VPC para listar endereços IP flutuantes em uma interface de rede de um servidor bare metal, é possível que você receba uma lista incompleta dos endereços IP flutuantes associados à interface de rede do servidor bare metal.

O IP flutuante associado a uma interface de rede bare metal não está disponível antes que a interface de rede status seja available.

Soluções Alternativas:

  • Aguarde até que as interfaces de rede do servidor bare metal estejam em estado “ available ” antes de listar os endereços IP flutuantes nessas interfaces.
  • Liste todos os IPs flutuantes para visualizar aqueles associados a interfaces de servidor bare metal que ainda não são available.

Criação de IPs reservados no console

Para criar um IP reservado, siga estas etapas:

  1. No menu “ IBM Cloud ”, selecione Infraestrutura > Rede > Sub-redes.
  2. Selecione uma sub-rede existente ou crie uma nova.
  3. Clique na guia IPs reservados.
  4. Clique em Criar +.

As seções a seguir descrevem o trabalho com endereços IP reservados com atributos diferentes.

Criando um IP reservado não associado

Para criar um IP reservado não associado, siga estas etapas:

  1. Digite um nome para o seu IP reservado. Assegure-se de usar caracteres alfanuméricos minúsculos sem espaços para o nome.
  2. Selecione se você deseja que o sistema escolha um IP reservado para você automaticamente, se deseja escolher em uma lista de IPs reservados existentes ou se deseja inserir um você mesmo.
  3. Selecione um endereço, se você precisar de um endereço IP específico (opcional).
  4. Clique em Reservar IP.

Excluindo um IP reservado

Para excluir (liberar) um endereço IP reservado usando a interface do usuário, acesse Sub-redes > Endereços IP reservados e clique no menu de ações ao lado do endereço IP reservado que você deseja excluir. Selecione “Lançar ”.

Trabalhando com endereços IP reservados pela CLI

É possível usar a CLI para criar, atualizar e excluir endereços IP reservados.

Antes de iniciar, configure o seu ambiente da CLI.

Criação de um endereço IP reservado pela CLI

Para reservar um endereço IP privado do VPC usando a CLI, execute o comando a seguir:

ibmcloud is subnet-reserved-ip-create SUBNET [--vpc VPC] [--name NAME] [--address IPADDRESS] [--auto-delete true | false] [--target TARGET] [--output JSON] [-q, --quiet]

Em que:

  • SUBNET é o ID da sub-rede.
  • --vpc é o ID ou nome do VPC. Esta opção somente será necessária se você quiser especificar o recurso exclusivo por nome dentro deste VPC.
  • --name é o nome definido pelo usuário para este IP reservado. Os nomes devem ser exclusivos dentro da sub-rede na qual o IP reservado reside. Os nomes iniciados com ibm- são reservados para recursos de propriedade do provedor.
  • --address é o endereço IP a ser reservado, que não deve já estar reservado na sub-rede. Se não for especificado, um endereço disponível na sub-rede será selecionado automaticamente.
  • --auto-delete determina como o recurso de exclusão automática é configurado. Se configurado como true, este IP reservado será automaticamente excluído quando o destino for excluído. Um de: true, false (padrão: true).
  • --target é o destino do IP reservado.
  • --output especifica o formato de saída; apenas JSON é suportado.
  • -q, --quiet suprime a saída detalhada.

Atualização de um endereço IP reservado pela CLI

Para atualizar um endereço IP reservado pela CLI, execute o seguinte comando:

ibmcloud is subnet-reserved-ip-update SUBNET RESERVED_IP [--vpc VPC] [--name NEW_NAME] [--auto-delete true | false] [--output JSON] [-q, --quiet]

Em que:

  • SUBNET é o ID da sub-rede.
  • RESERVED_IP é o ID do IP reservado.
  • --vpc é o ID ou nome do VPC. Somente será necessário se você desejar especificar o recurso exclusivo por nome dentro deste VPC.
  • --name é o novo nome do IP reservado.
  • --auto-delete determina como o recurso de exclusão automática é configurado. Se configurado como true, este IP reservado será automaticamente excluído quando o destino for excluído. Um de: true, false (padrão: true).
  • --output especifica o formato de saída; apenas JSON é suportado.
  • -q, --quiet suprime a saída detalhada.

Exclusão de um IP reservado pela CLI

Para excluir um endereço IP reservado pela CLI, é necessário desvincular esse endereço IP. Depois de desvincular o IP reservado, execute o comando a seguir para excluí-lo:

ibmcloud is subnet-reserved-ip-delete SUBNET (RESERVED_IP1 RESERVED_IP2 ...) [--vpc VPC] [-f, --force] [--output JSON] [-q, --quiet]

Em que:

  • SUBNET é o ID da sub-rede.
  • RESERVED_IP1 RESERVED_IP2 são os IDs dos IPs reservados. É possível especificar um ou mais.
  • --vpc é o ID ou nome do VPC. Somente será necessário se você desejar especificar o recurso exclusivo por nome dentro deste VPC.
  • --force, -f força a operação sem confirmação.
  • --output especifica o formato de saída; apenas JSON é suportado.
  • -q, --quiet suprime a saída detalhada.

Usando a API

Para criar um endereço IP reservado usando a API, siga estas etapas:

  1. Configure o seu Ambiente de API.

  2. Criar uma sub-rede.

  3. Armazene o ID da sub-rede em uma variável a ser usada no comando da API:

    export SubnetId=<your_subnet_id>

  4. Crie um IP reservado e, opcionalmente, especifique um endereço na propriedade address:

curl -X POST -sH "Authorization:${iam_token}" \
"$vpc_api_endpoint/v1/subnets/$SubnetId/reserved_ips?version=$api_version&generation=2" \
-d '{"name": "test-reserved-ip", "address": "10.240.0.15"}' | jq

O exemplo utiliza o jq como analisador sintático, uma ferramenta de terceiros licenciada sob a licença MIT. O jq pode não vir pré-instalado em todas as imagens de VPC disponíveis no momento da criação de uma instância. Talvez seja necessário instalar o jq antes de usá-lo ou utilizar outro analisador de sua preferência.

Excluindo um IP reservado

Use a API a seguir para excluir um IP reservado:

curl -X DELETE -sH "Authorization:${iam_token}" \
"$vpc_api_endpoint/v1/subnets/$SubnetId/reserved_ips/$ReservedIpId?version=$api_version&generation=2"
  • A API não permite que você exclua um IP reservado que está ligado a uma interface de rede primária. Uma instância de servidor virtual deve ter uma interface de rede primária, e todas as interfaces de rede devem ter um IP reservado.
  • Um IP reservado que está ligado a uma interface de rede secundária pode ser ligado a uma variedade de recursos, incluindo, mas não limitado a:
    • Interfaces de rede
    • Terminais privados virtuais (VPEs)
    • Balanceadores de carga.
    • Gateways VPN
    • Trabalhadores do IKS
    • Instâncias dos DNS Services
  • A desvinculação de um IP reservado excluirá o IP reservado se a propriedade auto-delete for configurada como true.

Quando auto-delete é desativado

Se você criar um IP reservado sem vinculá-lo, auto-delete será desativado por padrão. Um IP reservado que é desvinculado não pode ter auto-delete ativado.

Quando a opção auto-delete está desligada, a desvinculação deixa o IP reservado no lugar, mas não o exclui.

Quando auto-delete é ativado

Se você criar uma instância de servidor virtual sem especificar um IP reservado, o sistema criará um IP reservado para você e o ligará à interface de rede primária. Nesse cenário, o recurso de exclusão automática é ativado por padrão.

Quando a opção de exclusão automática está ligada, a desvinculação do IP reservado de seu destino resulta na exclusão do IP reservado.

Pode levar vários minutos para que o IP reservado seja excluído.