Este documento está destinado a propietarios del proyecto y a administradores de la organización que deseen agregar protecciones contra la eliminación de proyectos.
Puedes colocar una retención en un proyecto para bloquear su eliminación hasta que quites la retención. Esto puede ser útil a fin de proteger proyectos de gran importancia.
Las retenciones también se pueden implementar automáticamente en un proyecto. Por ejemplo, si permites que las cuentas de servicio de administración de identidades y accesos (IAM) de un proyecto se vinculen a los recursos de otros proyectos, se implementará una retención en el proyecto donde se ubican las cuentas de servicio.
Antes de comenzar
Gcloud CLI es la forma más fácil de interactuar con las retenciones del proyecto. Si no lo tienes instalado, puedes usar Google Cloud Shell.
Funciones obligatorias
A fin de obtener los permisos que necesitas para modificar retenciones, pídele a tu administrador que te otorgue el rol de IAM Modificador de retención de proyecto (roles/resourcemanager.lienModifier) en los proyectos.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.
Este rol predefinido contiene los permisos necesarios para modificar retenciones. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para modificar retenciones:
-
resourcemanager.projects.updateLiens -
Enumera retenciones en un proyecto:
resourcemanager.projects.get
También puedes obtener estos permisos con roles personalizados o, también, otros roles predefinidos.
Coloca una retención en un proyecto
Para colocar una retención en un proyecto, usa el comando alpha resource-manager liens create.
gcloud alpha resource-manager liens create \ --project=[PROJECT_ID] \ --restrictions=[PERMISSION_RESTRICTION] \ --reason=[LIEN_REASON] \ --origin=[LIEN_ORIGIN]
Reemplaza lo siguiente:
- [PROJECT_ID]: Es el ID del proyecto al que se aplica la retención.
- [PERMISSION_RESTRICTION]: Es la lista separada por comas de los permisos de IAM que se deben bloquear. La única restricción válida para un proyecto es
resourcemanager.projects.delete. - [LIEN_REASON]: Una descripción legible por humanos de por qué existe esta retención. Escribe esta descripción entre comillas dobles. Ejemplo:
"This project is protected by a lien". - [LIEN_ORIGIN]: Es una cadena que indica el usuario o sistema que originó la retención. Es un campo obligatorio, pero se propaga automáticamente con la dirección de correo electrónico del usuario si se omite.
Crea una lista de retenciones de un proyecto
Para enumerar todas las retenciones que se aplican a un proyecto, usa el comando alpha resource-manager liens list.
gcloud alpha resource-manager liens list
El resultado es similar al siguiente:
gcloud alpha resource-manager liens list
NAME ORIGIN REASON
p1061081023732-l3d8032b3-ea2c-4683-ad48-5ca23ddd00e7 user@example.com testing
Quita las retenciones de un proyecto
Para quitar una retención de un proyecto, usa el comando alpha resource-manager liens delete.
gcloud alpha resource-manager liens delete [LIEN_NAME]
Reemplaza [LIEN_NAME] por el nombre de la retención que deseas borrar, como liens/p1061081023732-l3d8032b3-ea2c-4683-ad48-5ca23ddd00e7.
Referencias
Referencia de la API: Recurso REST: retenciones