A migração de um Google Cloud projeto é uma operação de metadados que muda o local do projeto na hierarquia de recursos. Esta página oferece uma visão geral de como as migrações funcionam, o que permanece igual e o que muda quando um projeto é movido para uma nova organização.
Projetos na hierarquia de recursos
O recurso projeto é a entidade organizacional básica em um Google Cloud recurso da organização. Os projetos são criados em recursos da organização e podem ser colocados em pastas ou no próprio recurso da organização, formando a hierarquia de recursos.
Talvez seja necessário migrar projetos entre recursos da organização devido a aquisições, requisitos regulamentares ou separação de unidades de negócios. É possível usar a API Resource Manager para migrar esses projetos. A operação de migração retorna uma string que representa o nome da operação. A API também permite reverter uma migração, movendo o projeto de volta ao local original na hierarquia, se necessário.
Cenários de migração
O local do projeto determina qual dos dois caminhos você vai seguir:
- Migrar projetos de uma organização para outro recurso da organização.
- Migrar um projeto independente (criado sem uma organização) para a hierarquia de um recurso da organização.
Se você precisar mover um projeto de volta para Sem organização depois que ele estiver associado a um recurso da organização, entre em contato com o Cloud Customer Care. Não é possível fazer a reversão de uma organização para nenhuma organização por autoatendimento.
Além da API, também é possível usar o Google Cloud console para mover projetos. Para isso, selecione o projeto e atribua um novo destino pai.
Identificar o estado atual do projeto
Antes de começar, determine se o projeto está associado a um recurso da organização. Isso determina se você segue o caminho Da organização para a organização ou o caminho Sem organização.
Se você não tiver a permissão resourcemanager.organizations.get no
recurso da organização pai do projeto, é provável que seus projetos
não sejam exibidos conforme o esperado na organização real no
Google Cloud console. Isso pode fazer parecer que o projeto não está associado a nenhum recurso da organização.
Para determinar se o projeto está associado a um recurso da organização, execute o seguinte comando:
gcloud
gcloud projects get-ancestors PROJECT_ID
Substitua PROJECT_ID pelo ID do projeto que você quer migrar.
Se a saída incluir um tipo de recurso organization na hierarquia, o projeto já fará parte de uma hierarquia da organização.
Se o tipo organization estiver ausente ou vazio, o projeto será independente, sem recurso da organização.
Com base no estado do projeto, siga o guia relevante: