Mueve un proyecto

En esta guía, se explica cómo mover un proyecto dentro de tu recurso de organización.

El proyecto es la entidad organizativa básica en un Google Cloud recurso de organización. Los proyectos se crean en recursos de organización y se pueden colocar en carpetas o en el recurso de organización en sí, lo que forma la jerarquía de recursos. Puedes mover recursos de proyecto dentro de tu jerarquía de recursos, pero debes tener en cuenta las implicaciones de la política del movimiento antes de hacerlo.

Cuando mueves un proyecto, cualquier política de Identity and Access Management o política de la organización que esté conectada directamente se moverá con él. Sin embargo, un proyecto en tu jerarquía de recursos también se ve afectado por las políticas que hereda de los recursos superiores. Si un proyecto hereda un rol de IAM que otorga a los usuarios permiso para usar un servicio en particular, los usuarios no tendrán acceso a ese servicio en el destino, a menos que también hereden el permiso en el destino.

Por ejemplo, piensa en una cuenta de servicio que tenga el rol Creador de objetos de almacenamiento vinculado a un usuario en la carpeta A. La cuenta de servicio tiene permisos para subir datos a Cloud Storage en cualquier proyecto de la carpeta A. Si moviste uno de estos proyectos a la carpeta B, que no tiene los mismos permisos heredados, la cuenta de servicio de ese proyecto pierde la capacidad de subir datos, lo que provoca una interrupción del servicio.

Estas mismas consideraciones se aplican si las políticas de la organización se definen en las carpetas de origen y destino. Al igual que las políticas de IAM, las políticas de la organización se heredan. Por lo tanto, debes asegurarte de que las políticas de la organización sean coherentes entre las carpetas de origen y de destino.

Para obtener más información sobre las políticas de la organización, consulta Introducción al servicio de las políticas de la organización.

Para mover un proyecto, necesitas el rol de IAM Encargado de la transferencia del proyecto (roles/resourcemanager.projectMover) en la carpeta de origen y en la de destino. Si el recurso no está en una carpeta, necesitas este rol en el recurso de la organización.

Estos roles te otorgan los siguientes permisos obligatorios:

  • resourcemanager.projects.update en el proyecto
  • Si el recurso está en una carpeta: resourcemanager.projects.move en la carpeta de origen y el destino
  • Si el recurso no está en una carpeta: resourcemanager.projects.move en el recurso de la organización

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Console

Para mover un proyecto, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página Administrar recursos.

    Ir a Administrar recursos

  2. Selecciona tu organización en el menú desplegable Organización en la parte superior izquierda de la página.

  3. Haz clic en la fila del proyecto para seleccionarlo de la lista de recursos. Ten en cuenta que no debes hacer clic en el nombre del proyecto, que te lleva a la página de Identity and Access Management (IAM) del proyecto.

  4. Haz clic en el menú de opciones (los puntos suspensivos verticales) de la fila y haz clic en Mover.

  5. Haz clic en Explorar para seleccionar la carpeta a la que deseas mover el proyecto.

  6. Haz clic en Mover.

gcloud

Para mover un proyecto, ejecuta el gcloud beta projects move comando:

gcloud beta projects move PROJECT_ID \
   --DESTINATION_TYPE DESTINATION_ID

Reemplaza lo siguiente:

  • PROJECT_ID: El ID o el número del proyecto que deseas mover.
  • DESTINATION_TYPE: El tipo de destino, ya sea organization o folder.
  • DESTINATION_ID: El ID del recurso de la organización o la carpeta a la que deseas mover el proyecto.

REST

Puedes usar el método v3 projects.move para mover un proyecto.

Solicitud:

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

Reemplaza lo siguiente:

  • PROJECT_NAME: El nombre del proyecto que deseas actualizar. Por ejemplo, projects/415104041262

  • DESTINATION_PARENT: El nuevo recurso de organización superior o la carpeta en la que deseas mover el proyecto. Por ejemplo: organizations/12345678901

Si se realiza correctamente, la solicitud mostrará una operación que se puede usar para hacer un seguimiento del movimiento del proyecto.