Gerir projetos de inquilinos

Esta página descreve como criar, remover e eliminar projetos de inquilinos.

Utiliza a API Service Consumer Management para criar e configurar projetos de inquilinos, Google Cloud projetos que são usados para alojar os recursos do serviço gerido dedicados a um único consumidor de serviços. Cada projeto de inquilino está associado a uma unidade de arrendamento.

Uma unidade de arrendamento pode conter vários projetos de inquilinos, cada um com um tag: string identificador que pode usar para indicar a finalidade do projeto e para se referir a ele quando o desaprovisionar.

Após a criação, um projeto de inquilino é apenas um Google Cloud projeto na sua organização. Pode usar quaisquer ferramentas de gestão para trabalhar com ele como faria normalmente para um projeto. Google Cloud

Criar um projeto de inquilino

Para criar um projeto de inquilino e adicioná-lo a uma unidade de arrendamento, chame o método services.tenancyUnits.addProject.

O exemplo seguinte adiciona um novo projeto de inquilino com a etiqueta tag1 a uma unidade de arrendamento usando a API REST:

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

A chamada inclui os seguintes dados:

{"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 chamada devolve uma operação de longa duração que pode consultar para confirmar que a criação do projeto foi bem-sucedida.

O novo projeto de inquilino está configurado com uma restrição do projeto: uma propriedade definida no projeto de inquilino para evitar a eliminação acidental. Tem de chamar o método services.tenancyUnits.removeProject para libertar a caução e eliminar o projeto. Não é recomendável contornar esta proteção.

O projeto de inquilino é criado na pasta que especificou durante a configuração. Não é recomendável mover um projeto para uma pasta diferente depois de o criar.

A conta de serviço da API Service Consumer Management é o criador e o proprietário dos projetos de inquilinos, além de quaisquer outros proprietários especificados na configuração do projeto de inquilino. Não é recomendável remover esta conta como proprietária.

Em alguns casos, é recomendável atualizar um projeto existente para que se torne um projeto de inquilino, em vez de criar um novo projeto de inquilino. Google Cloud Para adicionar um Google Cloud projeto existente a uma unidade de arrendamento, chame o método services.tenancyUnits.attachProject.

Remover um projeto inquilino

Para remover um projeto de inquilino com a etiqueta abc, chame o método services.tenancyUnits.removeProject, conforme ilustrado no exemplo seguinte:

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

A chamada inclui os seguintes dados:

{"tag":"abc"}

Esta operação remove a restrição do projeto, elimina o projeto e todos os recursos no mesmo, e elimina todos os metadados associados da unidade de arrendamento.

Esta ação elimina o projeto e remove todos os metadados sobre o mesmo da unidade de posse. Se quiser eliminar o projeto, mas manter um registo do mesmo, use o método services.tenancyUnits.deleteProject em alternativa. Este método elimina o projeto e retém os metadados, anotando-os com o estado DELETED. Para anular a eliminação de um projeto eliminado, chame o método services.tenancyUnits.undeleteProject.