Mova um endereço IPv4 externo para um projeto diferente
Os endereços IPv4 externos estáticos estão associados a um Google Cloud projeto e só podem ser usados nesse projeto. No entanto, pode mover um endereço IPv4 externo estático de um projeto para outro.
Funções e autorizações do IAM
Para mover um endereço IP regional, tem de ter as seguintes autorizações:
compute.addresses.delete
no projeto de origemcompute.addresses.create
no projeto de destino
Para mover um endereço IP global, tem de ter as seguintes autorizações:
compute.globalAddresses.delete
no projeto de origemcompute.globalAddresses.create
no projeto de destino
Exemplos de funções que incluem estas autorizações:
- Administrador de computação (
roles/compute.admin
) - Administrador de rede de Calcular (
roles/compute.networkAdmin
) - Administrador de IP público do Compute (
roles/compute.publicIpAdmin
)
Antes de começar
- Confirme se os limites do sistema do seu projeto lhe permitem mover endereços IP.
Consulte os seguintes limites do sistema por projeto:
Se os valores do limite do sistema forem
0
, não pode mover endereços IP. Se precisar de mover endereços IP, contacte a sua Google Cloud equipa de vendas. - Verifique se o projeto para o qual quer mover o endereço IP existe. Caso contrário, crie um projeto.
- Ative a API Compute Engine no projeto de destino.
- Verifique se o projeto de destino tem capacidade disponível suficiente nas
quotas adequadas para os endereços IP que está a mover:
- Para endereços IP externos regionais, verifique a quota de endereços IP estáticos.
- Para endereços IP externos globais, verifique a quota global de endereços IP estáticos.
- Verifique se o endereço IP que quer mover tem os seguintes atributos:
- O tipo de acesso é externo.
- A versão de IP é IPv4.
- O endereço IP é reservado (estático) e não efémero. Para reservar um endereço IP, consulte o artigo Reserve um novo endereço IP externo estático.
- O endereço IP não está a ser usado por nenhum recurso, por exemplo, uma instância de VM ou uma regra de encaminhamento. Para anular a atribuição de um endereço IP, consulte o artigo Anule a atribuição de um endereço IP externo estático.
- O endereço IP não foi reservado pelo apoio técnico do Google Cloud como parte de um intervalo de endereços IP contíguo. Para mais informações, consulte o artigo A movimentação de um endereço IPv4 externo falha.
Limitações
Se anular a atribuição de um endereço IP, tem de aguardar algum tempo antes de o mover:
- Para endereços IP globais, aguarde 10 minutos.
- Para endereços IP regionais, aguarde 20 minutos.
Não pode alterar a região de um endereço IP regional.
Não pode converter um endereço IP global num endereço IP regional nem um endereço IP regional num endereço IP global.
Não pode mover endereços BYOIP entre projetos.
Mova um endereço IPv4 externo para um projeto diferente
Pode mover um endereço IPv4 externo regional ou global de um projeto para outro. Quando move o endereço IP, por predefinição, o recurso de endereço IP recebe o mesmo nome e descrição. No entanto, pode optar por atribuir um novo nome ou descrição. Depois de o endereço IPv4 externo ser movido para um novo projeto, pode atribuí-lo a recursos elegíveis nesse projeto.
Consola
Na Google Cloud consola, aceda a Endereços IP.
No menu Mais ações (
) do endereço IP que quer mover, selecione Mover para outro projeto.Clique em Selecionar projeto e, de seguida, selecione o projeto para o qual quer mover o endereço IP.
Opcional: introduza um novo Nome para o endereço IP.
Opcional: introduza uma nova Descrição para o endereço IP.
Clique em Mover.
gcloud
As opções de comando variam consoante esteja a mover um endereço IP regional ou global e consoante esteja a manter ou a substituir o nome ou a descrição do endereço. Os exemplos seguintes descrevem algumas destas combinações.
Mova um endereço IPv4 externo regional para um projeto diferente:
gcloud compute addresses move ADDRESS_NAME \ --target-project=TARGET_PROJECT \ --region=REGION
Mova um endereço IPv4 externo regional para um projeto diferente e atribua-lhe um novo nome e descrição no novo projeto:
gcloud compute addresses move ADDRESS_NAME \ --target-project=TARGET_PROJECT \ --new-name=NEW_NAME \ --description=NEW_DESCRIPTION \ --region=REGION
Mova um endereço IPv4 externo global para um projeto diferente:
gcloud compute addresses move ADDRESS_NAME \ --target-project=TARGET_PROJECT \ --global
Substitua o seguinte:
ADDRESS_NAME
: o nome do recurso de endereço IP que quer mover.TARGET_PROJECT
: o nome ou o ID do projeto para o qual quer mover o endereço IP.REGION
: a região do endereço IP.NEW_NAME
: um novo nome para o recurso de endereço IP no novo projeto.NEW_DESCRIPTION
: um novo nome para o recurso de endereço IP no novo projeto. Se for omitida, é usada a descrição existente, se existir, para o recurso.
Para mais informações, consulte a documentação de referência gcloud compute addresses
move
.
API
Os detalhes do pedido variam consoante esteja a mover um endereço IP regional ou global e consoante mantenha ou substitua o nome ou a descrição do endereço. Os exemplos seguintes descrevem algumas destas combinações.
Mova um endereço IPv4 externo regional para um projeto diferente:
POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/regions/REGION/addresses/ADDRESS_NAME/move { "destination_address": "projects/TARGET_PROJECT/global/addresses/ADDRESS_NAME", }
Mova um endereço IPv4 externo regional para um projeto diferente e atribua-lhe um novo nome e descrição no novo projeto:
POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/regions/REGION/addresses/ADDRESS_NAME/move { "destination_address": "projects/TARGET_PROJECT/global/addresses/NEW_NAME", "description": "NEW_DESCRIPTION", }
Mova um endereço IPv4 externo global para um projeto diferente:
POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/global/addresses/ADDRESS_NAME/move { "destination_address": "projects/TARGET_PROJECT/global/addresses/ADDRESS_NAME", }
Substitua o seguinte:
ADDRESS_NAME
: o nome do recurso de endereço IP que quer mover.SOURCE_PROJECT
: o nome ou o ID do projeto para o qual quer mover o endereço IP.TARGET_PROJECT
: o nome ou o ID do projeto para o qual quer mover o endereço IP.REGION
: a região do endereço IP.NEW_NAME
: um novo nome para o recurso de endereço IP no novo projeto.NEW_DESCRIPTION
: um novo nome para o recurso de endereço IP no novo projeto. Se for omitida, é usada a descrição existente, se existir, para o recurso.
Resolução de problemas
A movimentação de um endereço IPv4 externo falha
Pode ver a seguinte mensagem de erro quando tenta mover um endereço IPv4 externo:
Invalid resource usage: 'Cannot move address that belongs to a reserved address
range. Address range must be disassembled first.'
Se vir esta mensagem, significa que o endereço IP foi reservado pelo apoio técnico do Google Cloud como parte de um intervalo de endereços IP contíguos. Para mover um endereço IP deste tipo, contacte o apoio técnico do Google Cloud. O apoio técnico da nuvem pode mover todo o intervalo de endereços IP para outro projeto. Mover apenas parte do intervalo não é suportado.
Para verificar se um endereço IP faz parte de um intervalo reservado pelo Apoio técnico da nuvem, faça o seguinte:
- Liste os endereços IP externos estáticos e, em seguida, encontre o endereço IP que quer verificar.
- Verifique o nome do endereço IP. Se o endereço IP foi reservado pelo apoio técnico da nuvem, o respetivo nome é composto por uma string seguida pelos quatro bytes do endereço IP, separados por hífenes. Por exemplo, se um endereço IP for
198.51.100.2
e tiver sido reservado pelo apoio técnico do Google Cloud, o nome tem o seguinte formato:STRING-198-51-100-2
. Outros endereços IP que foram reservados como parte do mesmo intervalo partilham a mesma string, seguida dos respetivos endereços IP.