프로젝트는 Google Cloud 조직 리소스의 기본 수준 구성 항목입니다. 프로젝트는 조직 리소스 아래에 생성되며 리소스 계층 구조를 형성하는 폴더 또는 조직 리소스 자체에 배치될 수 있습니다. 리소스 계층 구조 내에서 프로젝트 리소스를 이동할 수 있지만 이동하기 전에 이동의 정책적 영향을 고려해야 합니다.
프로젝트를 이동하면 직접 연결된 모든 Identity and Access Management 정책 또는 조직 정책이 함께 이동됩니다. 하지만 리소스 계층의 프로젝트도 상위 리소스로부터 상속되는 정책의 영향을 받습니다. 사용자에게 특정 서비스 사용 권한을 제공하는 IAM 역할이 프로젝트에 상속될 경우, 대상에서도 권한이 상속되지 않으면 사용자가 대상에서 해당 서비스에 액세스하지 못합니다.
예를 들어 폴더 A에서 사용자에게 연결된 스토리지 객체 생성자 역할이 있는 서비스 계정을 가정해보세요. 이 서비스 계정은 폴더 A에서 어느 프로젝트에서든 Cloud Storage에 데이터를 업로드할 수 있는 권한이 있습니다. 이러한 프로젝트 중 하나를 폴더 B로 이동했을 때, 이 폴더에 동일하게 상속되는 권한이 없으면, 해당 프로젝트에 대한 서비스 계정이 데이터 업로드 기능을 상실하여, 서비스 중단이 발생합니다.
조직 정책이 소스 및 대상 폴더에서 정의되는 경우 동일한 고려사항이 적용됩니다. IAM 정책과 마찬가지로 조직 정책도 상속됩니다. 따라서 조직 정책이 소스 폴더와 대상 폴더 간에 일관되는지 확인해야 합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-12-21(UTC)"],[],[],null,["# Moving a project\n\nThis guide explains how to move a project within your organization resource.\n\nThe project is the base-level organizing entity in a\nGoogle Cloud organization resource. Projects are created\nunder organization resources, and can be placed under folders or the organization\nresource itself, forming the\n[resource hierarchy](/resource-manager/docs/cloud-platform-resource-hierarchy). You can move project\nresources within your resource hierarchy, but should consider the policy\nimplications of the move before you make it.\n| **Note:** The following instructions are only for moving a project within an organization resource. For information about migrating a project between organization resources, see [Migrating projects](/resource-manager/docs/project-migration).\n\nWhen you move a project, any Identity and Access Management policies or organization policies that\nare directly attached will move with it. However, a project in your resource\nhierarchy is also affected by the policies that it inherits from parent\nresources. If a project inherits an IAM role that provides users\npermission to use a particular service, users will not have access to that\nservice at the destination unless it would inherit the permission at the\ndestination as well.\n\nFor example, consider a service account has the **Storage Object Creator**\nrole bound to a user at Folder A. The service account has permissions to upload\ndata to Cloud Storage in any project in Folder A. If you moved one of these\nprojects to Folder B, which does not have the same inherited permissions, the\nservice account for that project loses the ability to upload data, resulting in\na service outage.\n\nThese same considerations apply if organization policies are defined at the\nsource and destination folders. Like IAM policies, organization\npolicies are inherited. Consequently, you must ensure that your organization\npolicies are consistent between source and destination folders.\n\nTo learn more about organization policies, see\n[Introduction to the organization Policy Service](/resource-manager/docs/organization-policy/overview).\n\nTo move a project, you need the Project Mover IAM role\n(`roles/resourcemanager.projectMover`) on both the source folder and the\ndestination folder. If the resource is not in a folder, you need this role on\nthe organization resource.\n\nThese roles give you the following required permissions:\n\n- `resourcemanager.projects.update` on the project\n- **If the resource is in a folder:** `resourcemanager.projects.move` on the source folder and the destination\n- **If the resource is not in a folder:** `resourcemanager.projects.move` on the organization resource\n\nYou can also gain these permissions with [custom\nroles](/iam/docs/creating-custom-roles), or other predefined roles. \n\n### Console\n\nTo move a project:\n\n1. In the Google Cloud console, go to the **Manage resources** page.\n\n [Go to Manage resources](https://console.cloud.google.com/cloud-resource-manager)\n\n \u003cbr /\u003e\n\n2. Select your Organization from the **Organization** drop-down on the top\n left of the page.\n\n3. Click on your project's row to select your project from the list of\n resources. Note that you *must not* click on the name of the\n project, which takes you to the project's IAM page.\n\n4. Click on the options menu (the vertical ellipsis) in the row and click\n **Move**.\n\n5. Click **Browse** to select the folder to which you want to move the\n project.\n\n6. Click **Move**.\n\n### gcloud\n\nTo move a project, run the\n[`gcloud beta projects move`](/sdk/gcloud/reference/beta/projects/move)\ncommand: \n\n```\ngcloud beta projects move PROJECT_ID \\\n--DESTINATION_TYPE DESTINATION_ID\n```\n\nWhere:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is the ID or number of the project you wish to\n move.\n\n- \u003cvar translate=\"no\"\u003eDESTINATION_TYPE\u003c/var\u003e is either `organization` or `folder`.\n\n- \u003cvar translate=\"no\"\u003eDESTINATION_ID\u003c/var\u003e is the ID of the organization resource or folder to which\n you want to move the project. You can only specify one target.\n\n### API\n\nYou can use the v3\n[`projects.move`](/resource-manager/reference/rest/v3/projects/move) method\nto move a project.\n\nRequest: \n\n```\nPOST https://cloudresourcemanager.googleapis.com/v3/{name=PROJECT_NAME}:move\n{\n \"destinationParent\": DESTINATION_PARENT\n}\n```\n\nWhere:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e is the name of the project you want\n to update. For example, `projects/415104041262`\n\n- \u003cvar translate=\"no\"\u003eDESTINATION_PARENT\u003c/var\u003e is the new parent organization resource\n or folder under which you want to move the project. For example:\n `organizations/12345678901`\n\nIf successful, the request will return an\n[Operation](/resource-manager/reference/rest/Shared.Types/Operation) which\ncan be used to track the project move."]]
