Como criar e excluir unidades de locação

Uma unidade de locação é uma entidade leve que representa o relacionamento de um consumidor, normalmente um projeto de consumidor de serviço que ativou suas APIs, e seu serviço gerenciado. Apenas uma unidade de locação por consumidor de serviço pode estar ativa por vez.

O nome do recurso de uma unidade de locação tem este formato:

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

O código da unidade de locação é gerado automaticamente quando você o cria. Também é possível fornecer o código ao chamar o método services.tenancyUnits.create. Se você fornecer um código, ele precisará ser exclusivo no escopo do serviço gerenciado, para todos os consumidores de serviço. Ocorrerá erro se uma unidade de locação com um código diferente já existir para o mesmo consumidor de serviço.

Antes de começar

Para criar e excluir unidades de locação, você precisa seguir as instruções de configuração iniciais em Primeiros passos com a API Service Consumer Management.

Como criar uma unidade de locação

Para criar uma unidade de locação usando a REST API, chame o seguinte método HTTP, com os devidos tokens de autorização no cabeçalho:

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

Aqui, projects/12345678901 é o consumidor de serviço do serviço gerenciado e your-service.example.com é o nome do serviço gerenciado.

A estrutura de dados de locação retornada tem o nome da unidade de locação.

Você pode criar uma unidade de locação assim que o consumidor de serviço ativar o serviço gerenciado.

Quando você não fornece um código e já existe uma unidade de locação para o consumidor, essa unidade de locação é retornada como resultado.

Como excluir uma unidade de locação

Para excluir uma unidade de locação, primeiro remova todos os projetos dela usando o método services.tenancyUnits.removeProject. Em seguida, chame o método services.tenancyUnits.delete para remover a unidade de locação:

DELETE https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits/absdef
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Service Infrastructure