Como transferir um projeto

Neste guia, explicamos como mover um projeto na sua organização.

O recurso de projeto é a entidade organizacional de nível básico em uma organização do Google Cloud. Os projetos são criados em organizações e podem ser colocados em pastas ou no próprio recurso da organização, formando a hierarquia de recursos. É possível mover recursos do projeto dentro da hierarquia, mas considere as implicações da política antes de fazer isso.

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

Por exemplo, considere que uma conta de serviço tenha o papel Criador de objetos do Storage vinculado a um usuário na pasta A. A conta de serviço tem permissões para fazer o upload de dados para o Cloud Storage em qualquer projeto, na Pasta A. Se você moveu um desses projetos, 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 políticas da organização são herdadas. Consequentemente, garanta que as políticas da organização sejam consistentes entre as pastas de origem e de destino.

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

Para mover um projeto, você precisa dos seguintes papéis do IAM:

  1. Ter a permissão resourcemanager.projects.update no projeto, que normalmente acompanha os papéis Editor do projeto ou Proprietário do projeto.

  2. Ter a permissão resourcemanager.projects.move nas pastas de origem e de destino. Essa permissão geralmente faz parte dos papéis Proprietário do projeto, Editor do projeto, Administrador da pasta ou Movimentador de pastas. Se o recurso não estiver em uma pasta, você precisará dessa permissão no nó da organização.

Console

Para mover um projeto:

  1. No Console do 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, porque isso leva você até a página do IAM do projeto.

  4. Clique no menu de opções (as reticências verticais) da linha e clique 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

Em que:

  • PROJECT_ID é o ID ou número do projeto que você quer mover.

  • DESTINATION_TYPE é organization ou folder.

  • DESTINATION_ID é o ID da organização ou pasta para onde você quer mover o projeto. Só é possível especificar um destino.

API

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

Solicitação:

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

Em que:

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

  • DESTINATION_PARENT é a nova organização ou pasta pai em que você quer mover o projeto. Por exemplo: organizations/12345678901

Se for bem-sucedida, a solicitação retornará uma Operation que pode ser usada para rastrear a transferência do projeto.