Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta lista de verificação vai ajudar você a migrar projetos entre recursos da organização. A
lista de verificação abaixo contém uma lista das principais tarefas envolvidas na migração de um
projeto entre recursos da organização, instruções breves para cada etapa e um link
para mais informações.
Pense em como sua migração afetará os serviços em execução no projeto. As mudanças na hierarquia de recursos causadas pela migração de um projeto podem levar a alterações nas políticas herdadas, como políticas da organização e de permissão e negação do Identity and Access Management (IAM).
Crie um plano para garantir que os possíveis impactos sejam atenuados durante a migração do projeto. Para ajudar a informar seu plano, use a
API Move Analysis para ver um detalhamento dos obstáculos à
migração do projeto.
Você precisa de um conjunto específico de papéis do IAM para migrar um projeto entre recursos da organização. Você também precisará de permissão para criar e gerenciar políticas da organização.
Para receber essas permissões, adquira os papéis a seguir:
Transportador de projeto (roles/resourcemanager.projectMover) no projeto que você quer migrar e o recurso pai.
Criador de projetos (roles/resourcemanager.projectCreator) na pasta
ou recurso da organização de destino.
Administrador de políticas da organização (roles/orgpolicy.policyAdmin) nos recursos da organização de origem e destino.
Para saber mais sobre os papéis e permissões necessários, consulte
Atribuir permissões.
Para migrar um projeto entre recursos de organização, defina as seguintes políticas da organização:
Defina a restrição constraints/resourcemanager.allowedExportDestinations no recurso pai do projeto que você quer migrar. Essa restrição define os recursos da organização para os quais o projeto pode ser migrado.
Defina a restrição
constraints/resourcemanager.allowedImportSources no recurso de destino. Essa restrição define os recursos da organização de onde os projetos podem ser importados.
Se uma dessas restrições não estiver configurada corretamente, a migração falhará
com um erro FAILED_PRECONDITION.
Para configurar as políticas da organização necessárias para a migração do projeto, você precisa ter o papel roles/orgPolicy.policyAdmin na organização mãe e de destino.
Ao migrar um projeto entre recursos da organização, talvez seja necessário resolver determinados cenários no nível do projeto e do recurso da organização. Pode haver serviços envolvidos que você precisa considerar como parte do plano de migração. Considere esses casos se depender dos serviços envolvidos na operação do projeto.
Depois de concluir as etapas acima, você pode usar a API Resource Manager para migrar um projeto. Use o comando da Google Cloud CLI gcloud beta projects move
ou o método da API REST projects.update() para
fazer a migração.
Para mais detalhes sobre como migrar seu projeto, consulte
Executar a migração.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[],[],null,["# Project migration checklist\n\nThis checklist will help you to migrate projects between organization resources. The\nchecklist below contains a list of the major tasks involved in migrating a\nproject between organization resources, brief instructions for each step, and a link\nto more information. \n\n\n### [Create a migration plan](#create_migration_plan)\n\nYou should consider how your migration will impact the services running inside the project. Changes in the resource hierarchy caused by a project migration can lead to changes in inherited policies, such as organization policies and Identity and Access Management (IAM) allow and deny policies.\n\n\u003cbr /\u003e\n\nCreate a plan to make sure that any potential impacts are mitigated during your\nproject migration. To help inform your plan, use the\n[Move Analysis API](/resource-manager/docs/analyze-move) to get a detailed breakdown of blockers for\nthe project migration.\n\nFor more information, see\n[Create a migration plan](/resource-manager/docs/create-migration-plan).\n\n### [Assign Identity and Access Management roles](#assign_roles)\n\nYou need a particular set of IAM roles to migrate a project between organization resources. You will also need permission to create and manage organization policies.\n\n\u003cbr /\u003e\n\nYou can get these permissions by acquiring the following roles:\n\n- Project Mover (`roles/resourcemanager.projectMover`) on the project you want\n to migrate and its parent resource.\n\n- Project Creator (`roles/resourcemanager.projectCreator`) on the destination\n folder or organization resource.\n\n- Organization Policy Admin (`roles/orgpolicy.policyAdmin`) on both the source\n and destination organization resources.\n\nFor more details about the roles and permissions you need, see\n[Assign permissions](/resource-manager/docs/assign-iam-roles).\n\n### [Configure organization policies](#set_organization_policies)\n\nTo perform a project migration between organization resources, you must set the following organization policies:\n\n\u003cbr /\u003e\n\n- Set the `constraints/resourcemanager.allowedExportDestinations` constraint on the parent resource to the project that you want to migrate. This constraint defines the organization resources to which the project can be migrated.\n\n- Set the\n `constraints/resourcemanager.allowedImportSources` constraint on the destination resource. This constraint defines the organization resources from which projects can be imported.\n\nIf either of these constraints are not properly set, the migration will fail\nwith a `FAILED_PRECONDITION` error.\n\nTo configure organization policies required for the project migration, you\nmust have the `roles/orgPolicy.policyAdmin` role on the parent and the destination organization.\n\nFor more information about these organization policy constraints, see\n[Configure organization policies](/resource-manager/docs/configure-org-policy).\n\n### [Address any special cases](#special_cases)\n\nWhen you migrate a project between organization resources, there is a chance you'll need to address certain scenarios at the project and organization resource level. There can be services involved that you'd need to consider that As part of your migration plan, you should consider these cases if you depend on the services involved for the operation of your project.\n\n\u003cbr /\u003e\n\nFor a list of special cases and how to handle them, see\n[Handling special cases](/resource-manager/docs/handle-special-cases).\n\n### [Perform the migration](#perform_migration)\n\nOnce you have finished the above steps, you can use the Resource Manager API to migrate a project. You can use the `gcloud beta projects move` Google Cloud CLI command, or the `projects.update()` REST API method to perform the migration.\n\n\u003cbr /\u003e\n\nFor more details about migrating your project, see\n[Perform the migration](/resource-manager/docs/perform-migration)."]]
