Crea y borra unidades de inquilino

Una unidad de inquilino es una entidad básica que representa la relación de un consumidor, por lo general, un proyecto del consumidor de servicios que habilitó tus API y tu servicio administrado. Solo puede haber una unidad de inquilino activa por consumidor de servicios a la vez.

El nombre del recurso de una unidad de inquilino tiene el siguiente formato:

/services/{your cloud service name}/projects/{consumer project number}/tenancyUnits/{id}

El ID de la unidad de inquilino se genera automáticamente cuando la creas. También puedes proporcionar el ID cuando llamas al método services.tenancyUnits.create. Si proporcionas un ID, este debe ser único dentro del alcance de tu servicio administrado para todos los consumidores de servicios. Se generará un error si ya existe una unidad de inquilino con un ID diferente para el mismo consumidor de servicios.

Antes de comenzar

Para crear y borrar unidades de inquilino, debes seguir las instrucciones de configuración iniciales en Comienza a usar la API de Service Consumer Management.

Crea una unidad de inquilino

Para crear una unidad de inquilino con la API de REST, llama al siguiente método HTTP con los token de autorización adecuados en el encabezado:

POST https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits

Aquí, projects/12345678901 es el consumidor de servicios del servicio administrado y your-service.example.com es el nombre de tu servicio administrado.

La estructura de los datos de inquilino que se muestra tiene el nombre de la unidad de inquilino.

Puedes crear una unidad de inquilino tan pronto como el consumidor de servicios habilite el servicio administrado.

Si no proporcionas un ID y ya existe una unidad de inquilino para el consumidor, esa unidad de inquilino se muestra como el resultado.

Borra una unidad de inquilino

Para borrar una unidad de inquilino, primero quita todos los proyectos en tal unidad mediante el uso del método services.tenancyUnits.removeProject. A continuación, llama al método services.tenancyUnits.delete para quitar la unidad de inquilino:

DELETE https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits/absdef