En esta página se describe cómo crear, quitar y eliminar proyectos de arrendatario.
La API Service Consumer Management se usa para crear y configurar proyectos de cliente,Google Cloud proyectos que se usan para alojar los recursos de tu servicio gestionado dedicados a un solo usuario del servicio. Cada proyecto de arrendatario está asociado a una unidad de arrendamiento.
Una unidad de arrendamiento puede contener varios proyectos de arrendatario, cada uno con un identificador tag: string que puede usar para indicar el propósito del proyecto y para hacer referencia a él al desaprovisionarlo.
Una vez creado, un proyecto de arrendatario es un Google Cloud proyecto de tu organización. Puedes usar cualquier herramienta de gestión para trabajar con él como lo harías normalmente con un Google Cloud proyecto.
Crear un proyecto de cliente
Para crear un proyecto de arrendatario y añadirlo a una unidad de arrendatario, llama al método services.tenancyUnits.addProject.
En el siguiente ejemplo se añade un nuevo proyecto de arrendatario con la etiqueta tag1 a una unidad de arrendamiento mediante la API REST:
POST https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits/absdef:addProject
La llamada incluye los siguientes datos:
{"tag":"tag1", "project_config":{"folder":"folders/9876543210", "tenant_project_policy":{"policy_bindings":{"role":"roles/owner", "members":"user:bob@example.com"}}, "billing_config":{"billing_account":"billingAccounts/123456-472F22-28F9AA"}}}
Esta llamada devuelve una operación de larga duración que puedes consultar para confirmar que el proyecto se ha creado correctamente.
El nuevo proyecto de arrendatario se configura con una retención de proyecto: una propiedad definida en el proyecto de arrendatario para evitar que se elimine de forma accidental. Debes llamar al método
services.tenancyUnits.removeProject
para liberar la retención y eliminar el proyecto. No se recomienda eludir esta protección.
El proyecto de arrendatario se crea en la carpeta que especificaste durante la configuración. No se recomienda mover un proyecto a otra carpeta después de crearlo.
La cuenta de servicio de la API Service Consumer Management es la creadora y propietaria de los proyectos de arrendatario, además de cualquier otro propietario que se especifique en la configuración del proyecto de arrendatario. No se recomienda quitar esta cuenta como propietaria.
En algunos casos, puede que quieras actualizar un proyecto para que se convierta en un proyecto de arrendatario en lugar de crear uno nuevo. Google Cloud Para añadir un proyectoGoogle Cloud a una unidad de arrendamiento, llama al método services.tenancyUnits.attachProject.
Eliminar un proyecto de cliente
Para quitar un proyecto de inquilino con la etiqueta abc, llama al método services.tenancyUnits.removeProject, como se muestra en el siguiente ejemplo:
POST https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits/absdef:removeProject
La llamada incluye los siguientes datos:
{"tag":"abc"}
Esta operación elimina el bloqueo del proyecto, el proyecto y todos los recursos que contiene, así como los metadatos asociados de la unidad de arrendamiento.
Se elimina el proyecto y se quitan todos los metadatos relacionados con él de la unidad de arrendamiento. Si quieres eliminar el proyecto, pero conservar un registro del mismo, llama al método
services.tenancyUnits.deleteProject
en su lugar. Este método elimina el proyecto y conserva los metadatos, que se anotan con el estado DELETED. Para recuperar un proyecto eliminado, llama al método services.tenancyUnits.undeleteProject.