Mover um projeto

É possível mover um projeto do Google Cloud no recurso da organização para reorganizar a hierarquia de recursos e se alinhar à reestruturação da equipe, às mudanças de departamento ou aos requisitos de acesso atualizados. Como a entidade organizadora de nível básico no Google Cloud, um projeto pode residir diretamente no recurso da organização ou em uma pasta. Antes de mover um projeto, avalie as implicações da política do destino, porque o projeto herda as políticas de identidade e da organização do novo pai.

Quando você move um projeto, todas as políticas de gerenciamento de identidade e acesso ou políticas da organização anexadas diretamente serão movidas com ele. No entanto, um projeto na hierarquia de recursos também é afetado pelas políticas herdadas de recursos pai. Se um projeto herdar um papel do IAM que concede aos usuários permissão para usar um serviço específico, eles não terão acesso a esse serviço no destino, a menos que ele também herde a permissão no destino.

Por exemplo, considere que uma conta de serviço tem o papel de criador de objetos do Storage vinculado a um usuário na Pasta A. A conta de serviço tem permissões para fazer upload de dados para o Cloud Storage em qualquer projeto na Pasta A. Se você mover um desses projetos para a Pasta B, que não tem as mesmas permissões herdadas, a conta de serviço desse projeto perderá a capacidade de fazer upload de dados, resultando em uma interrupção do serviço.

Essas mesmas considerações se aplicam se as políticas da Organização estiverem definidas nas pastas de origem e de destino. Assim como as políticas de IAM, as da Organização são herdadas. Portanto, você precisa garantir que as políticas da Organização sejam consistentes entre as pastas de origem e de destino.

Para saber mais sobre as políticas da organização, consulte Introdução ao serviço de políticas da organização.

Para mover um projeto, você precisa do papel do IAM de transportador de projetos (roles/resourcemanager.projectMover) na pasta de origem e na pasta de destino. Se o recurso não estiver em uma pasta, você precisará desse papel no recurso da organização.

Esses papéis concedem as seguintes permissões exigidas:

  • resourcemanager.projects.update no projeto
  • Se o recurso estiver em uma pasta: resourcemanager.projects.move na pasta de origem e na pasta de destino.
  • Se o recurso não estiver em uma pasta: resourcemanager.projects.move no recurso da organização

Também é possível conseguir essas permissões com papéis personalizados ou outros papéis predefinidos.

Console

Para mover um projeto, siga estas etapas:

  1. No console Google Cloud , acesse a página Gerenciar recursos.

    Acesse "Gerenciar recursos"

  2. Selecione a organização na lista suspensa Organização, na parte superior esquerda da página.

  3. Clique na linha do projeto para selecioná-lo na lista de recursos. Não clique no nome do projeto, que leva à página do Identity and Access Management (IAM) do projeto.

  4. Clique no menu "opções" (as reticências verticais) na linha e em Mover.

  5. Clique em Procurar para selecionar a pasta para que você quer mover o projeto.

  6. Clique em Mover.

gcloud

Para mover um projeto, execute o comando gcloud beta projects move:

gcloud beta projects move PROJECT_ID \
   --DESTINATION_TYPE DESTINATION_ID

Substitua:

  • PROJECT_ID: o ID ou número do projeto que você quer mover.
  • DESTINATION_TYPE: o tipo do destino, organization ou folder.
  • DESTINATION_ID: o ID do recurso ou da pasta da organização para onde você quer mover o projeto.

REST

Use o método v3 projects.move para mover um projeto.

Solicitação:

POST https://cloudresourcemanager.googleapis.com/v3/{name=PROJECT_NAME}:move
{
  "destinationParent": DESTINATION_PARENT
}

Substitua:

  • PROJECT_NAME: o nome do projeto que você quer atualizar. Por exemplo, projects/415104041262

  • DESTINATION_PARENT: o novo recurso ou pasta da organização pai em que você quer mover o projeto. Por exemplo: organizations/12345678901

Se for bem-sucedida, a solicitação retornará uma Operação que pode ser usada para rastrear a movimentação do projeto.