Mover um endereço IPv4 externo para outro projeto

Os endereços IPv4 externos estáticos são associados a um projeto do Google Cloud e só podem ser usados nesse projeto. No entanto, é possível mover um endereço IPv4 externo estático de um projeto para outro.

Permissões e papéis do IAM

Para mover um endereço IP regional, você precisa ter as seguintes permissões:

compute.addresses.delete no projeto de origem
compute.addresses.create no projeto de destino

Para mover um endereço IP global, é necessário ter as seguintes permissões:

compute.globalAddresses.delete no projeto de origem
compute.globalAddresses.create no projeto de destino

Exemplos de papéis que incluem essas permissões:

Administrador do Compute (roles/compute.admin)
Administrador de rede do Compute (roles/compute.networkAdmin)
Administração de IP público do Compute (roles/compute.publicIpAdmin)

Antes de começar

Verifique se o projeto para o qual você quer mover o endereço IP existe. Se não estiver, crie um projeto.
Ative a API Compute Engine no projeto de destino.
Verifique se o projeto de destino tem capacidade disponível suficiente nas cotas apropriadas para os endereços IP que você está movendo:
- Para endereços IP externos regionais, verifique a cota de endereços IP estáticos.
- Para endereços IP externos globais, verifique a cota global de endereços IP estáticos.
- Para todos os endereços IP, verifique as cotas de solicitação de mudança de endereço.
Verifique se o endereço IP que você quer mover tem os seguintes atributos:
- O tipo de acesso é externo.
- A versão do IP é IPv4.
- O endereço IP é reservado (estático), e não temporário.
  
  Para reservar um endereço IP, consulte Reservar um novo endereço IP externo estático.
- O endereço IP não está sendo usado por nenhum recurso, por exemplo, uma instância de VM ou uma regra de encaminhamento.
  
  Para cancelar a atribuição de um endereço IP, consulte Cancelar a atribuição de um endereço IP externo estático.
- O endereço IP não foi reservado pelo suporte do Cloud como parte de um intervalo de endereços IP contíguo. Para mais informações, consulte Falha ao mover um endereço IPv4 externo.

Limitações

Se você cancelar a atribuição de um endereço IP, precisará aguardar algum tempo antes de movê-lo:
- Para endereços IP globais, aguarde 10 minutos.
- Para endereços IP regionais, aguarde 20 minutos.
Não é possível alterar a região de um endereço IP regional.
Não é possível converter um endereço IP global em regional ou vice-versa.

Cotas

Há um limite de quantos endereços você pode mover por minuto. Para mais informações, veja a seguir as cotas por projeto na documentação da VPC:

Mover um endereço IPv4 externo para um projeto diferente

Você pode mover um endereço IPv4 externo regional ou global de um projeto para outro. Ao mover o endereço IP, por padrão, o recurso dele recebe o mesmo nome e descrição. No entanto, é possível atribuir uma descrição ou um nome novo. Depois que o endereço IPv4 externo é movido para um novo projeto, é possível atribuí-lo a recursos qualificados desse projeto.

Console

No console do Google Cloud, acesse Endereços IP.

Acessar endereços IP
No menu mais ações () do endereço IP que você quer mover, selecione Mover para outro projeto.
Clique em Selecionar projeto e selecione o projeto para onde você quer mover o endereço IP.
Opcional: digite um novo Nome para o endereço IP.
Opcional: insira uma nova Descrição para o endereço IP.
Clique em Mover.

gcloud

As opções de comando variam dependendo se você está movendo um endereço IP regional ou global e se está mantendo ou substituindo o nome ou a descrição do endereço. Os exemplos a seguir descrevem algumas dessas combinações.

Mova um endereço IPv4 externo regional para outro projeto:

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 a ele 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 outro projeto:

gcloud compute addresses move ADDRESS_NAME \
    --target-project=TARGET_PROJECT \
    --global

Substitua:

ADDRESS_NAME: o nome do recurso de endereço IP que você quer mover.
TARGET_PROJECT: o nome ou ID do projeto para onde você 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 omitido, a descrição atual, se houver, será usada para o recurso.

Para mais informações, consulte a documentação de referência do gcloud compute addresses move.

API

Os detalhes da solicitação variam dependendo se você está movendo um endereço IP regional ou global e se está mantendo ou substituindo o nome ou a descrição do endereço. Os exemplos a seguir descrevem algumas dessas combinações.

Mova um endereço IPv4 externo regional para outro projeto:

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 a ele 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 outro projeto:

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:

ADDRESS_NAME: o nome do recurso de endereço IP que você quer mover.
SOURCE_PROJECT: o nome ou ID do projeto para onde você quer mover o endereço IP.
TARGET_PROJECT: o nome ou ID do projeto para onde você 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 omitido, a descrição atual, se houver, será usada para o recurso.

Solução de problemas

Falha ao mover um endereço IPv4 externo

Talvez você veja a seguinte mensagem de erro ao tentar 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.'

Essa mensagem significa que o endereço IP foi reservado pelo suporte do Cloud como parte de um intervalo de endereços IP contíguo. Para mover um endereço IP desse tipo, entre em contato com o suporte do Cloud. O suporte do Cloud pode mover todo o intervalo de endereços IP para outro projeto. Não é possível mover apenas parte do intervalo.

Para verificar se um endereço IP faz parte de um intervalo reservado pelo suporte do Cloud, faça o seguinte:

Liste os endereços IP externos estáticos e encontre aquele que você quer verificar.
Verifique o nome do endereço IP. Se o endereço IP tiver sido reservado pelo suporte do Cloud, o nome dele será composto por uma string seguida pelos quatro bytes do endereço IP, separados por hífens. Por exemplo, se um endereço IP for 198.51.100.2 e tiver sido reservado pelo suporte do Cloud, o nome dele terá o seguinte formato: STRING-198-51-100-2. Outros endereços IP reservados como parte do mesmo intervalo compartilham a mesma string, seguida pelos endereços IP deles.