Traslada un proyecto

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

El recurso de proyecto es la entidad organizadora básica en una organización de Google Cloud. Los proyectos se crean en organizaciones y se pueden colocar en carpetas o en el recurso de la organización y forma la jerarquía de recursos. Puedes mover los recursos del proyecto dentro de tu jerarquía de recursos, pero debes considerar las implicaciones de la política del traslado antes de crearlo.

Cuando trasladas un proyecto, cualquier política de Identity and Access Management o de la organización que esté conectada de forma directa 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 una función de IAM que proporciona 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 heredara el permiso en el destino.

Por ejemplo, supongamos que una cuenta de servicio tiene la función de creador de objetos de almacenamiento vinculada 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 trasladaste uno de estos proyectos a la carpeta B, que no tiene los mismos permisos heredados, la cuenta de servicio para 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 la página sobre la introducción al servicio de políticas de la organización.

Para mover un proyecto, necesitas las siguientes funciones de IAM:

  1. Debes tener el permiso resourcemanager.projects.update en el proyecto, que se suele generar si tienes las funciones Editor de proyectos o Propietario de proyectos en el proyecto.

  2. Debes tener el permiso resourcemanager.projects.move en la carpeta de origen y en la de destino. Este permiso suele formar parte de las funciones de Propietario de proyectos, Editor de proyectos, Administrador de carpetas o Encargado de transferencia de carpetas. Si el recurso no está en una carpeta, necesitarás este permiso en el nodo de la organización.

Console

Para mover un proyecto, sigue estos pasos:

  1. En Google Cloud Console, 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 de tu proyecto para seleccionar el proyecto 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 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 comando gcloud beta projects move:

gcloud beta projects move PROJECT_ID \
--DESTINATION_TYPE DESTINATION_ID

Aquí:

  • PROJECT_ID es el ID o número del proyecto que deseas mover.

  • DESTINATION_TYPE es organization o folder.

  • DESTINATION_ID es el ID de la organización o carpeta a la que deseas mover el proyecto. Solo puedes especificar un objetivo.

API

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

Solicitud:

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

Aquí:

  • PROJECT_NAME es el nombre del proyecto que deseas actualizar. Por ejemplo, projects/415104041262

  • DESTINATION_PARENT es la nueva organización o carpeta superior en la que deseas mover el proyecto. Por ejemplo: organizations/12345678901

Si se ejecuta con éxito, la solicitud mostrará una Operación que se puede usar para realizar un seguimiento del movimiento del proyecto.