Criação de intervalos de endereços públicos
É possível criar um intervalo de endereços públicos definindo seu tamanho e, opcionalmente, especificando uma VPC para associá-lo a qualquer zona de disponibilidade dentro da conta.
Se a VPC for excluída enquanto estiver vinculada a um intervalo de endereços públicos, o intervalo de endereços continuará existindo e poderá ser vinculado posteriormente a uma VPC diferente em qualquer zona de disponibilidade.
É possível criar intervalos de endereços públicos com o console, a CLI, a API e o Terraform.
Antes de Iniciar
Certifique-se de analisar as considerações de planejamento para faixas de endereços públicos.
Criação de intervalos de endereços públicos no console
Para criar intervalos de endereços públicos no console IBM Cloud, siga estas etapas:
-
No console IBM Cloud, selecione o
do menu Navegação e clique em
de infraestrutura > Rede > Intervalos de endereços públicos. A página Public Address Ranges for VPC é exibida.
-
Clique em Criar para acessar a página de fornecimento.
-
Na seção “Localização”, indique a região onde você deseja que o intervalo de endereços públicos seja criado.
-
Na seção Detalhes, preencha as informações a seguir:
-
Tamanho: Selecione o tamanho (número de endereços IP) do intervalo de endereços. Você pode escolher entre 1, 2, 4, 8 ou 16 IPs para incluir no bloco.
Depois de criar um intervalo de endereços públicos, não é possível alterar seu tamanho.
-
Nome: (Opcional): Digite um nome para o intervalo de endereços públicos, como
my-public-address-range. -
Grupo de recursos: Selecione um grupo de recursos para o intervalo de endereços públicos.
Depois de criar um intervalo de endereços públicos, você não poderá alterar o grupo de recursos.
-
Tags: (Opcional) Adicione tags para ajudar a organizar e localizar seus recursos. Você sempre pode adicionar mais tags mais tarde. Para obter mais informações, consulte Trabalhando com tags.
-
-
(Opcional) Se você quiser vincular seu intervalo de endereços públicos a uma VPC existente, coloque o botão “Vincular ” na posição “Ativado ”. Em seguida, selecione a VPC e a zona de disponibilidade às quais você deseja se vincular.
Você pode vincular um intervalo de endereços públicos a qualquer VPC em uma única zona de disponibilidade que já exista em sua conta. Você também pode vincular o intervalo de endereços a uma VPC posteriormente. Para obter mais informações, consulte Vinculação de um intervalo de endereços públicos.
-
Clique em Criar. O intervalo de endereços públicos é solicitado para uso.
Na página Intervalos de endereços públicos para VPC, seu intervalo de endereços agora é exibido na tabela. Para os serviços IBM Cloud, o status de seu intervalo de endereços públicos muda de Updating para Stable.
Criação de intervalos de endereços públicos a partir da CLI
Para criar intervalos de endereços públicos a partir da linha de comando, siga estas etapas:
-
Configure seu ambiente da CLI.
-
Faça login no seu ambiente CLI. Depois de inserir a senha, o sistema pergunta qual conta e região você deseja usar:
ibmcloud login --sso -
Ative o sinalizador de recurso a seguir:
export IBMCLOUD_IS_FEATURE_PUBLIC_ADDRESS_RANGE=trueVocê receberá uma notificação na linha de comando quando atualizações para a CLI do IBM Cloud e seus plug-ins estiverem disponíveis. É importante manter sua CLI atualizada para acessar os comandos mais recentes. Para verificar a versão atual de todos os plug-ins instalados, execute
ibmcloud plugin list. -
Execute o comando a seguir:
ibmcloud is public-address-range-create --ipv4-address-count IPV4_ADDRESS_COUNT [--name NAME] [--vpc VPC --zone ZONE] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]Em que:
--ipv4-address-count- O número total de endereços IPv4 públicos requeridos. Deve ser uma potência de 2.
--name- Um nome para o intervalo de endereços públicos. Nomes que começam com “
ibm-” são reservados para recursos gerenciados pelo provedor e não são permitidos. --vpc- A VPC à qual esse intervalo de endereços públicos deve ser vinculado. Requer o
--zone``. --zone- A zona em que se encontra esse intervalo de endereços públicos. Requer o
--vpc``. --resource-group-id- O ID do grupo de recursos. É mutuamente exclusivo com
--resource-group-name. --resource-group-name- Nome do grupo de recursos. É mutuamente exclusivo com
--resource-group-id. --output- Quanto ao formato de saída, apenas JSON é compatível. Um de: JSON.
-q, --quiet- Suprimir a saída detalhada.
Exemplos de comando
Crie um intervalo de endereços públicos chamado public-address-range-1 com uma contagem de endereços de 8:
ibmcloud is public-address-range-create --name public-address-range-1 --ipv4-address-count 8
Crie um intervalo de endereços público denominado “ public-address-range-2 ”, com 4 endereços, e um grupo de recursos denominado “ Default ”:
ibmcloud is public-address-range-create --name public-address-range-2 --ipv4-address-count 4 --resource-group-name Default
Crie um intervalo de endereços públicos chamado public-address-range-3 com uma contagem de endereços de 8, vinculado ao VPC cli-test-vpc na zona us-south-1 com ID de grupo de recursos 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3:
ibmcloud is public-address-range-create --name public-address-range-3 --ipv4-address-count 8 --vpc cli-test-vpc --zone us-south-1 --resource-group-id 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
Criação de intervalos de endereços públicos com a API
Antes de começar, configure seu ambiente de API.
Selecione uma das opções a seguir:
-
Crie um intervalo de endereços públicos a partir de IPs gerenciados p IBM, vinculados a uma VPC:
curl -sX POST \ "$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \ -H "Authorization: Bearer $iam_token" \ -H "Content-Type: application/json" \ -d '{ "ipv4_address_count": 8, "name": "my-public-address-range", "target": { "vpc": { "id": "r006-4727d842-f94f-4a2d-824a-9bc9b02c523b" }, "zone": { "name": "us-south-1" } } }' -
Crie um intervalo de endereços públicos não vinculados a partir de IPs gerenciados pel IBM:
curl -sX POST \ "$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \ -H "Authorization: Bearer $iam_token" \ -H "Content-Type: application/json" \ -d '{ "ipv4_address_count": 8, "name": "my-public-address-range" }'
Se precisar alterar o tamanho do intervalo de endereços ou do grupo de recursos, você deverá excluir e recriar o intervalo de endereços.
Criação de intervalos de endereços públicos com o Terraform
Para criar um intervalo de endereços públicos com o Terraform, use o exemplo a seguir:
resource "ibm_is_public_address_range" "example" {
ipv4_address_count = 8
name = "my-public-address-range"
resource_group {
id = data.ibm_resource_group.example.id
}
target {
vpc {
id = ibm_is_vpc.example.id
}
zone {
name = "us-south-1"
}
}
}