Reserve um endereço IP externo estático
Pode reservar endereços IP externos estáticos. Também pode listar e libertar os seus endereços IP externos estáticos reservados. Para atribuir um endereço IP externo estático a uma instância de máquina virtual (VM), consulte o artigo Configurar endereços IP externos estáticos.
Os endereços IP externos podem ser estáticos ou efémeros. Se uma VM precisar de um endereço IP externo fixo que não se altere, pode obter um endereço IP externo estático. Pode reservar novos endereços IP externos ou promover endereços IP externos efémeros existentes.
Se precisar de um endereço IP interno estático, consulte o artigo Reserve um endereço IP interno estático em alternativa.
Antes de começar
- Leia acerca dos endereços IP.
- Leia acerca das quotas e dos limites para endereços IP externos estáticos.
- Leia acerca dos preços dos endereços IP externos.
- Se ainda não o fez, configure a autenticação.
A autenticação é o processo através do qual a sua identidade
é validada para acesso a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode fazer a autenticação da seguinte forma.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:
gcloud init
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
Terraform
Para usar os exemplos do Terraform nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as credenciais predefinidas da aplicação com as suas credenciais de utilizador.
Instale a CLI Google Cloud.
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para mais informações, consulte Configure o ADC para um ambiente de desenvolvimento local na Google Cloud documentação de autenticação.
REST
Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.
Instale a CLI Google Cloud.
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.
Funções necessárias
Para receber as autorizações de que precisa para reservar e gerir endereços IP estáticos, peça ao seu administrador para lhe conceder a função do IAM Administrador da rede de computação (
roles/compute.networkAdmin
) no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.Esta função predefinida contém as autorizações necessárias para reservar e gerir endereços IP estáticos. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
São necessárias as seguintes autorizações para reservar e gerir endereços IP estáticos:
-
compute.addresses.create
-
compute.addresses.createInternal
-
compute.networks.list
-
compute.subnetworks.use
-
compute.subnetworks.list
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
Acerca dos endereços IP externos estáticos
Um endereço IP externo estático é o endereço IP reservado para o seu recurso até decidir libertá-lo. Se tiver um endereço IP no qual os seus clientes ou utilizadores confiam para aceder ao seu serviço, pode reservar esse endereço IP para que apenas o seu recurso o possa usar. Também pode promover um endereço IP externo efémero para um endereço IP externo estático.
Para mais informações, consulte o artigo Endereços IP.
A tabela seguinte indica os endereços IP externos estáticos suportados pelo Google Cloud.
Tipo de endereço IP Recurso Intervalo de IP Origem Associado a Endereços IPv4 externos regionais VMs e balanceadores de carga regionais /32
Conjunto de endereços IP externos da Google Projeto Endereços IPv6 externos regionais VMs e balanceadores de carga regionais suportados /96
Intervalo de endereços IPv6 externos da sub-rede Sub-rede Endereços IPv4 externos globais Balanceadores de carga globais /32
Conjunto de endereços IP externos da Google Projeto Endereços IPv6 externos globais Balanceadores de carga globais /64
Conjunto de endereços IP externos da Google Projeto Para ver uma lista de balanceadores de carga regionais e globais, consulte o Resumo dos tipos de balanceadores de carga.
Os endereços IP externos atribuídos existem no mesmo anfitrião físico que a VM e existem na mesma região que a VM para todos os fins, incluindo o encaminhamento, a latência e os preços. Isto é verdade independentemente das informações de pesquisa de geolocalização na Internet.
Limitações
Apenas um recurso de cada vez pode usar um endereço IP externo estático.
Não existe forma de verificar se um endereço IP é estático ou efémero depois de ter sido atribuído a um recurso. Pode comparar o endereço IP com a lista de endereços IP externos estáticos reservados para esse projeto. Use o subcomando
gcloud compute addresses list
para ver uma lista de endereços IP externos estáticos disponíveis para o projeto.Cada VM pode ter várias interfaces de rede e cada interface pode ter os seguintes endereços IP atribuídos de acordo com o respetivo tipo de pilha:
- Interfaces apenas IPv4:
- Um endereço IPv4 interno (obrigatório)
- Um endereço IPv4 externo (opcional)
- Interfaces de pilha dupla (IPv4 e IPv6):
- Um endereço IPv4 interno (obrigatório)
- Um endereço IPv4 externo (opcional)
- Um intervalo de endereços IPv6, interno ou externo, mas não ambos (obrigatório)
/96
- Interfaces apenas IPv6:
- Um intervalo de endereços IPv6, interno ou externo, mas não ambos (obrigatório)
/96
- Um intervalo de endereços IPv6, interno ou externo, mas não ambos (obrigatório)
- Interfaces apenas IPv4:
Não pode anular a atribuição nem alterar o endereço IPv6 externo de uma VM com uma interface de rede apenas IPv6. No entanto, pode promover um endereço IP externo efémero de um recurso para um endereço IP externo estático, para que o endereço permaneça reservado mesmo após a eliminação do recurso.
Não pode alterar o nome de um endereço IP estático.
Nota: as interfaces de rede podem receber tráfego de várias regras de encaminhamento, que podem publicar outros endereços IP externos. Qualquer número de endereços IP externos pode fazer referência a uma interface de rede através destas regras de encaminhamento, mas só pode ser atribuído um endereço IPv4 externo e um intervalo de endereços IPv6 externos a cada interface de rede.
/96
Para mais informações sobre o balanceamento de carga e as regras de encaminhamento, leia a documentação sobre o balanceamento de carga.
Reserve um novo endereço IP externo estático
Depois de reservar o endereço, atribua-o a uma nova VM durante a criação ou a uma VM existente.
Consola
- Na Google Cloud consola, aceda à página Endereços IP.
- Clique em Reservar endereço IP estático externo.
- No campo Nome, introduza um nome de endereço IP.
- Especifique se o nível do serviço de rede é Premium ou Standard. A reserva de endereços estáticos IPv6 só é suportada no nível Premium.
- Especifique se é um endereço IPv4 ou IPv6.
- Especifique se este endereço IP é Regional ou Global.
- Se estiver a reservar um endereço IP estático para um balanceador de carga global, escolha Global e, de seguida, clique em Reservar.
- Se estiver a reservar um endereço IP estático para uma VM ou para um balanceador de carga regional, escolha Regional e, em seguida, selecione a região na qual quer criar o endereço.
Se estiver a reservar um endereço IPv6 externo regional, também deve escolher o seguinte:
- Rede: a rede da VPC
- Sub-rede: a sub-rede a partir da qual atribuir o endereço IPv6 regional estático
- Tipo de ponto final: escolha Instância de VM ou Balanceador de carga de rede
Opcional: se estiver a reservar o endereço IP externo estático para uma VM, na lista Anexado a, selecione uma VM à qual anexar o endereço IP.
Clique em Reservar para reservar o endereço IP.
gcloud
Para reservar um endereço IP externo estático, use o comando
gcloud compute addresses create
.Use as instruções seguintes para reservar um endereço IPv4 ou IPv6 externo estático:
Endereço IP global
Para reservar um endereço IP global:gcloud compute addresses create ADDRESS_NAME \ --global \ --ip-version=IP_VERSION
Endereço IPv4 externo regional
Para reservar um endereço IPv4 externo regional:gcloud compute addresses create ADDRESS_NAME \ --region=REGION
Endereço IPv6 externo regional
Para reservar um endereço IPv6 externo regional:gcloud compute addresses create ADDRESS_NAME \ --region=REGION \ --subnet=SUBNET_NAME \ --ip-version=IPV6 \ --endpoint-type=ENDPOINT_TYPE
Substitua o seguinte:
ADDRESS_NAME
: o nome que quer associar a esta morada.REGION
: para endereços IP externos regionais, especifique uma região para o endereço IP.SUBNET_NAME
: para endereços IPv6 externos regionais, especifique a sub-rede a partir da qual atribuir o endereço IPv6 regional estático. A sub-rede tem de ter um intervalo de endereços IPv6 externos atribuídos.IP_VERSION
: para endereços IP globais, especifique a versão do IP,IPv4
ouIPv6
.ENDPOINT_TYPE
: para endereços IPv6 externos regionais, especifique o tipo de ponto final,VM
ouNETLB
.
Para ver o resultado, use o comando
gcloud compute addresses describe
:gcloud compute addresses describe ADDRESS_NAME
Terraform
Pode usar o recurso
google_compute_address
para criar um endereço IP externo regional.O exemplo seguinte mostra como usar o recurso
google_compute_global_address
para criar um endereço IPv6 externo global:API
Para criar um endereço IPv4 regional, chame o método regional
addresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
O corpo do pedido deve conter o seguinte:
{ "name": "ADDRESS_NAME" }
Substitua o seguinte:
PROJECT_ID
: o ID do projeto para este pedidoREGION
: o nome da região para este pedidoADDRESS_NAME
: o nome que quer associar à morada
Para endereços IPv4 estáticos globais, chame o método
globalAddresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
O corpo do pedido deve conter o seguinte:
{ "name": "ADDRESS_NAME" }
Para endereços IPv6 estáticos globais, chame o método
globalAddresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
O corpo do pedido deve conter o seguinte:
{ "name": "ADDRESS_NAME", "ipVersion": "IPV6" }
Para ver o resultado, use o método
addresses.get
.Para endereços IPv6 estáticos regionais, chame o método
addresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
O corpo do pedido deve conter o seguinte:
{ "name": "ADDRESS_NAME", "ipVersion": "IPV6", "ipv6EndpointType": "VM|LB", "networkTier": "PREMIUM", "subnetwork": "SUBNET" }
Substitua
SUBNET
pela sub-rede deste projeto.Para ver o resultado, use o método
addresses.get
.
Ir
Java
Python
Promova um endereço IP externo efémero
Se a sua VM tiver um endereço IP externo efémero e quiser atribuir permanentemente o endereço IP ao seu projeto, promova o endereço IP externo efémero a um endereço IP externo estático. A promoção de um endereço IP externo efémero para reservado não faz com que Google Cloud sejam perdidos pacotes enviados para a VM. Isto inclui pacotes enviados diretamente para a VM ou através de um equilibrador de carga.
Consola
- Aceda à página Endereços IP.
- Clique em Endereços IP externos.
- Opcional: no campo Filtrar, pesquise o endereço IP efémero que quer promover.
- No menu Mais ações ( ) do endereço IP que quer promover, selecione Promover para endereço IP estático.
- Introduza um nome para o novo endereço IP estático e, de seguida, clique em Reservar.
gcloud
Siga as instruções abaixo para promover um endereço IPv4 ou IPv6 externo estático:
Para promover um endereço IPv4 externo efémero para um endereço IPv4 externo estático, forneça o endereço IP externo efémero através da flag
--addresses
com o comandocompute addresses create
. Use a flagregion
para promover um endereço IP regional efémero ou a flagglobal
para promover um endereço IP global efémero.gcloud compute addresses create ADDRESS_NAME --addresses=IP_ADDRESS \ [--region=REGION | --global]
Substitua o seguinte:
ADDRESS_NAME
: o nome que quer associar a esta morada.IP_ADDRESS
: o endereço IP que quer promover.REGION
: a região à qual o endereço IP regional pertence.
Para promover um endereço IPv6 externo regional efémero para um endereço IPv6 externo regional estático, forneça o endereço IP externo efémero através da flag
--addresses
com o comandogcloud compute addresses create
.gcloud compute addresses create ADDRESS_NAME \ --region=REGION \ --addresses=IPV6_ADDRESS \ --prefix-length=96
Substitua o seguinte:
ADDRESS_NAME
: um nome para o recurso de endereço IP.REGION
: a região do recurso de endereço IPv6.IPV6_ADDRESS
: o endereço IPv6 que está a promover.
API
Para promover um endereço IP regional efémero, chame o método
addresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Para promover um endereço IP global efémero, faça um pedido
POST
ao URI seguinte:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
Especifique os valores dos campos obrigatórios do corpo do pedido:
Para endereços IPv4, o corpo do pedido deve conter os seguintes campos:
{ "name": "ADDRESS_NAME", "address": "IPV4_ADDRESS" "addressType": "EXTERNAL" }
Para endereços IPv6, o corpo do pedido deve conter os seguintes campos:
{ "name": "ADDRESS_NAME", "address": "IPV6_ADDRESS" "prefixLength": 96 "addressType": "EXTERNAL" }
Substitua o seguinte:
ADDRESS_NAME
: o nome que quer associar a esta moradaIPV4_ADDRESS|IPV6_ADDRESS
: o endereço IPv4 ou IPv6 que quer promoverREGION
: a região à qual o endereço IPv4 ou IPv6 pertencePROJECT_ID
: o ID do projeto para este pedido
Ir
Java
Python
O endereço IP externo permanece associado à VM, mesmo depois de ter sido promovido a um endereço IP externo estático. Se precisar de atribuir o endereço IP externo estático recém-promovido a outro recurso, desatribua o endereço IP externo estático da VM existente.
Liste endereços IP externos estáticos
Para listar os endereços IP externos estáticos que reservou para o seu projeto, siga estes passos.
Consola
Na Google Cloud consola, aceda à página Endereços IP.
Clique em Endereços IP externos.
gcloud
Use o comando
gcloud compute addresses list
:Para apresentar uma lista de todos os endereços IP, use o seguinte comando:
gcloud compute addresses list
Para apresentar uma lista de todos os endereços IP globais, use o seguinte comando:
gcloud compute addresses list --global
Para apresentar uma lista de todos os endereços IP regionais numa determinada região, use o seguinte comando:
gcloud compute addresses list \ --regions=REGION
Substitua
REGION
pela região para a qual quer apresentar uma lista de moradas. Pode listar endereços de várias regiões especificando nomes de regiões separados por vírgulas:gcloud compute addresses list \ --regions=REGION1,REGION2,..REGION_n_
API
Para listar endereços IPv4 ou IPv6 regionais, chame o método
addresses.list
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Substitua o seguinte:
PROJECT_ID
: o ID do projeto para este pedidoREGION
: o nome da região para este pedido
Para apresentar uma lista de todas as moradas em todas as regiões, chame o método
addresses.aggregatedList
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/addresses
Para listar endereços IPv4 ou IPv6 globais, chame o método
globalAddresses.list
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
Substitua o seguinte:
PROJECT_ID
: o ID do projeto para este pedido
Ir
Java
Python
Descreva um endereço IP externo estático
Para obter informações sobre um endereço IP externo estático, siga estes passos.
Consola
Na Google Cloud consola, aceda à página Endereços IP.
Clique em Endereços IP externos.
Clique no endereço IP sobre o qual quer obter mais informações.
gcloud
Use o comando
gcloud compute addresses describe
. SubstituaADDRESS_NAME
pelo nome do endereço IP externo que quer descrever.Para um endereço IPv4 ou IPv6 global, use o seguinte comando:
gcloud compute addresses describe ADDRESS_NAME --global
Para um endereço IPv4 ou IPv6 regional, use o seguinte comando:
gcloud compute addresses describe ADDRESS_NAME --region=REGION
API
Para descrever um endereço IPv4 ou IPv6 regional, chame o método
addresses.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME
Substitua o seguinte:
PROJECT_ID
: o ID do projeto do pedidoREGION
: o nome da região para o pedidoADDRESS_NAME
: o nome do endereço IP
Para descrever um endereço IPv4 ou IPv6 global, chame o método
globalAddresses.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses/ADDRESS_NAME
Substitua o seguinte:
PROJECT_ID
: o ID do projeto do pedidoADDRESS_NAME
: o nome do endereço IP
Ir
Java
Python
Libertar um endereço IP externo estático
Se já não precisar de um endereço IPv4 ou IPv6 externo estático, pode libertar o endereço IP eliminando o recurso de endereço IP.
Se estiver a usar a consola Google Cloud , só pode libertar um endereço IP estático se não estiver a ser usado por outro recurso.
Se estiver a usar a CLI gcloud ou a API, pode libertar um endereço IP, quer esteja ou não a ser usado por outro recurso.
Se o endereço IP não estiver a ser usado por um recurso, o endereço IP é devolvido ao conjunto de endereços IP externos disponíveis.
Se o endereço IP estiver a ser usado por um recurso, permanece associado ao recurso até que este seja eliminado.
Consola
Na Google Cloud consola, aceda à página Endereços IP.
Clique em Endereços IP externos.
Opcional: no campo Filtro, introduza
static
e, de seguida, selecione Estático : tipo na lista pendente.Selecione o endereço IP externo estático que quer libertar.
Clique em Retirar endereço estático.
Se não vir esta opção, clique no menu Mais ações (
) na barra de menu superior e, de seguida, selecione Libertar endereço estático na lista.
gcloud
Use o comando
compute addresses delete
:gcloud compute addresses delete ADDRESS_NAME
Substitua
ADDRESS_NAME
pelo nome do endereço IPv4 ou IPv6 a libertar.API
Para libertar um endereço IPv4 ou IPv6 regional, chame o método
addresses.delete
:DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME
Substitua o seguinte:
PROJECT_ID
: o ID do projeto para este pedidoREGION
: o nome da região para este pedidoADDRESS_NAME
: o nome do endereço IP
Para libertar um endereço IPv4 ou IPv6 global, chame o método
globalAddresses.delete
:DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses/ADDRESS_NAME
Substitua o seguinte:
ADDRESS_NAME
: o nome do endereço IPPROJECT_ID
: o ID do projeto para este pedido
Ir
Java
Python
O que se segue?
- Saiba como configurar endereços IP externos estáticos para uma VM nova ou existente.
- Saiba mais sobre as especificações de endereços IP para regras de encaminhamento e como usar regras de encaminhamento na vista geral das regras de encaminhamento.
- Saiba mais sobre endereços IP.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-23 UTC.
-