Vinculação, desvinculação e movimentação de intervalos de endereços públicos
Você pode vincular, desvincular e mover intervalos de endereços públicos para uma VPC em uma zona de disponibilidade com o console, a CLI, a API e o Terraform.
Antes de Iniciar
Analise os seguintes requisitos e considerações antes de vincular, desvincular ou mover um intervalo de endereços públicos:
- Certifique-se de analisar as considerações de planejamento para faixas de endereços públicos.
- A vinculação de um intervalo de endereços públicos deve incluir tanto uma VPC quanto uma zona de disponibilidade.
- Ao utilizar um intervalo de endereços públicos, é necessário configurar o roteamento de entrada após vincular o intervalo de endereços, a fim de direcionar o tráfego para o recurso apropriado. A vinculação do intervalo de endereços a uma VPC não encaminha automaticamente o tráfego para o recurso.
Vinculação, desvinculação e movimentação de intervalos de endereços públicos no console
É possível vincular, desvincular e mover um intervalo de endereços públicos para uma VPC em uma zona de disponibilidade no console.
Vinculação de um intervalo de endereços públicos no console
Para vincular um intervalo de endereços públicos no console IBM Cloud®, siga estas etapas:
- No console IBM Cloud, selecione o
do menu de navegação e clique no
de infraestrutura > Rede > Intervalos de endereços públicos. A página Public Address Ranges for VPC é exibida.
- Realce a linha do intervalo de endereços na tabela e clique em Bind (Vincular ) no menu Actions (Ações )
).
- Na página “Vincular intervalo de endereços de endereço público ”, selecione a VPC e a zona de disponibilidade correspondente à qual você deseja vincular o intervalo de endereços.
- Clique em Bind (Vincular ) para vincular o intervalo de endereços públicos à VPC.
Desvinculação de um intervalo de endereços públicos no console
Para desvincular um intervalo de endereços públicos no console IBM Cloud, siga estas etapas:
Depois que um endereço público é desvinculado, ele continua reservado e disponível para ser vinculado novamente.
- No console IBM Cloud, selecione o
do menu de navegação e clique no
de infraestrutura > Rede > Intervalos de endereços públicos. A página Public Address Ranges for VPC é exibida.
- Realce a linha do intervalo de endereços na tabela e clique em Unbind (Desvincular ) no menu Actions (Ações )
).
- Clique em Unbind para confirmar que deseja desvincular esse intervalo de endereços da VPC.
Mover um intervalo de endereços públicos no console
Se o intervalo de endereços públicos estiver vinculado a uma VPC em uma zona de disponibilidade, você poderá atualizá-lo e vinculá-lo (movê-lo) a uma VPC e zona de disponibilidade diferentes. O intervalo de endereços públicos é automaticamente desvinculado de sua VPC e zona de disponibilidade e, em seguida, vinculado à VPC e à zona de disponibilidade recém-especificadas.
Não é necessário desvincular o intervalo de endereços de seu destino original primeiro.
Para mover um intervalo de endereços públicos no console, siga estas etapas:
- No console IBM Cloud, selecione o
do menu de navegação e clique no
de infraestrutura > Rede > Intervalos de endereços públicos. A página Public Address Ranges for VPC é exibida.
- Realce a linha do intervalo de endereços na tabela e clique em Edit (Editar ) no menu Actions (Ações),
).
- Na página “Editar intervalo de endereços públicos ”, selecione a VPC e a zona de disponibilidade para a qual você deseja mover o intervalo de endereços.
- Clique em Save (Salvar ) para vincular o intervalo de endereços públicos à nova VPC.
Vinculação, desvinculação e movimentação de intervalos de endereços públicos na CLI
Para vincular, desvincular ou mover um endereço IP reservado a partir da linha de comando, siga estas etapas:
-
Configure seu ambiente da CLI.
-
Faça login em seus ambientes CLI. Depois de inserir a senha, o sistema pergunta qual conta e região você deseja usar:
ibmcloud login --sso -
Ative o seguinte sinalizador de recurso:
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-update PUBLIC_ADDRESS_RANGE [--name NAME] ([--vpc VPC --zone ZONE] | [--reset-target]) [--output JSON] [-q, --quiet]Em que:
PUBLIC_ADDRESS_RANGE- A ID ou o nome do intervalo de endereços públicos a ser atualizado.
--name- Um novo identificador para o intervalo de endereços públicos, se você quiser renomeá-lo.
--vpc- A VPC à qual você deseja associar o intervalo de endereços públicos. Ao especificar a opção
--vpc,--zoneé obrigatório. --zone- A zona na qual você deseja que esse intervalo de endereços públicos esteja localizado. Ao especificar a opção
--zone,--vpcé obrigatório. --reset-target- Desvincular um intervalo de endereços públicos.
-f, --force- Force a operação sem confirmação.
--output- Quanto ao formato de saída, apenas JSON é compatível. Um de: JSON.
-q, --quiet- Suprimir a saída detalhada.
Exemplos de comando
Se um endereço público não estiver vinculado a uma VPC, você poderá vinculá-lo a uma VPC em qualquer zona de disponibilidade:
ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --vpc cli-test-vpc --zone us-south-1
Desvincular um intervalo de endereços públicos de uma VPC e deixá-lo desvinculado:
ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --reset-target
Mover um intervalo de endereços públicos de uma VPC para outra:
ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --vpc cli-test-vpc --zone us-south-2
Vinculação, desvinculação e movimentação de intervalos de endereços públicos com a API
Para vincular, desvincular ou mover intervalos de endereços públicos com a API, siga estas etapas:
- Configure o seu Ambiente de API.
- Armazene os valores a seguir nas variáveis a serem usadas no comando da API:
version (string): A versão da API, no formato YYYY-MM-DD.
-
Quando todas as variáveis estiverem inicializadas, selecione uma das seguintes ações:
- Vincular um intervalo de endereços públicos a uma VPC específica:
curl -X PATCH \ "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \ -H "Authorization: Bearer $iam_token" \ -H "Content-Type: application/json" \ -d '{ "target": { "vpc": { "id": "r006-4727d842-f94f-4a2d-824a-9bc9b02c523b" }, "zone": { "name": "us-south-2" } } }'
-
Desvincular um intervalo de endereços públicos de uma VPC específica:
curl -X PATCH \
"$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
"target": null
}'
```
Depois que um endereço público é desvinculado, ele continua reservado e pode ser vinculado novamente.
{: note}
* Mover um intervalo de endereços públicos de uma VPC para outra:
```sh {: pre}
curl -X PATCH \
"$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
"target": {
"vpc": {
"id": "r006-9999aaaa-bbbb-cccc-dddd-1234567890ab"
},
"zone": {
"name": "us-south-3"
}
}
}'
```
## Vinculação, desvinculação e movimentação de intervalos de endereços públicos com o Terraform {: #par-bind-unbind-terraform terraform}
Para vincular, desvincular ou mover um intervalo de endereços públicos com o Terraform, use o exemplo a seguir:
```terraform {: codeblock}
resource "ibm_is_public_address_range" "public_address_range_instance" {
ipv4_address_count = "16"
name = "example-public-address-range"
resource_group{
id = "11caaa983d9c4beb82690daab08717e9"
}
target{
vpc {
id = ibm_is_vpc.testacc_vpc.id
}
zone {
name = "us-south-3"
}
}
}