Traslada un proyecto

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

El proyecto es la entidad organizadora básica en un Recurso de la organización de Google Cloud. Se crean los proyectos en recursos de la organización y se pueden colocar en carpetas u recursos de la recurso en sí, lo que forma jerarquía de recursos. Puedes mover recursos del proyecto dentro de tu jerarquía de recursos, pero debes considerar las implicaciones de la política del traslado antes de hacerlo.

Cuando muevas un proyecto, se moverán con él las políticas de Identity and Access Management o de la organización que se adjunten directamente. Sin embargo, un proyecto en tu recurso la jerarquía también se ve afectada por las políticas que hereda del elemento superior de Google Cloud. 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 herede el permiso en el destino también.

Por ejemplo, considera una cuenta de servicio que tiene el rol de 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, de servicio del proyecto perderá la capacidad de subir datos, lo que provocará que 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 de encargado de transferencia de proyectos (roles/resourcemanager.projectMover) en la carpeta de origen y en la carpeta de destino. Si el recurso no está en una carpeta, necesitas este rol en el recurso de la organización.

Estos roles otorgan los siguientes permisos necesarios:

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

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

Console

Para mover un proyecto, sigue estos pasos:

  1. En la consola de Google Cloud, 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 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 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 gcloud beta projects move :

gcloud beta projects move PROJECT_ID \
--DESTINATION_TYPE DESTINATION_ID

Aquí:

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

  • DESTINATION_TYPE es organization o folder.

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

API

Puedes usar la versión 3 Método projects.move 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. para actualizarlo. Por ejemplo, projects/415104041262

  • DESTINATION_PARENT es el nuevo recurso superior de la organización o la carpeta a la que quieres mover el proyecto. Por ejemplo: organizations/12345678901

Si se realiza correctamente, la solicitud devolverá Operación que se puede usar para hacer un seguimiento del traslado del proyecto.