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 origem
  • compute.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 origem
  • compute.globalAddresses.create no projeto de destino

Exemplos de funções que incluem estas autorizações:

Antes de começar

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

  1. Na Google Cloud consola, aceda a Endereços IP.

    Aceda a Endereços IP

  2. No menu Mais ações () do endereço IP que quer mover, selecione Mover para outro projeto.

  3. Clique em Selecionar projeto e, de seguida, selecione o projeto para o qual quer mover o endereço IP.

  4. Opcional: introduza um novo Nome para o endereço IP.

  5. Opcional: introduza uma nova Descrição para o endereço IP.

  6. 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:

  1. Liste os endereços IP externos estáticos e, em seguida, encontre o endereço IP que quer verificar.
  2. 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.