A página descreve os passos que têm de ser concluídos antes de poder começar a usar a API Service Consumer Management. Parte do princípio de que já tem umGoogle Cloud projeto e um serviço gerido (como um serviço gerido criado com os Cloud Endpoints) nesse projeto e que compreende as unidades de arrendamento.
Ativar o serviço
Embora a API Service Consumer Management ajude a gerir a utilização dos seus próprios serviços geridos, também é um serviço em si. Por conseguinte, antes de a poder usar, tem de ativar a API Service Consumer Management para o Google Cloud projeto que aloja o seu serviço gerido. Este projeto é conhecido como um projeto de produtor de serviços.
A forma mais simples de ativar a API Service Consumer Management para o seu projeto de produtor de serviços é usar a Google Cloud consola. Em alternativa, pode ativá-lo a partir da linha de comandos ou de forma programática. Pode saber mais em Ativar e desativar serviços.
Definir autorizações
Depois de a API Service Consumer Management ser ativada para o projeto do produtor de serviços, tem de criar a sua própria identidade de serviço e conceder-lhe autorizações nos seus recursos para que possa criar projetos de inquilinos nas suas pastas e configurar a conta de faturação correta nos projetos de inquilinos. Estas ações são executadas por uma conta de serviço pertencente à API Service Consumer Management, que é especificada no seguinte formato:
service-PROJECT_NUMBER@service-consumer-management.iam.gserviceaccount.com
onde PROJECT_NUMBER é o número do projeto do produtor de serviços que ativou o serviço de gestão de consumidores de serviços.
O resto deste guia usa GCM_SA para representar a conta de serviço da API Service Consumer Management.
Pode usar os seguintes comandos para gerar a identidade do serviço.
- Inicie sessão com a sua conta de utilizador.
gcloud auth login
- Gere a identidade do serviço.
gcloud beta services identity create --service=serviceconsumermanagement.googleapis.com --project=PROJECT_ID
Definir autorizações de pastas
Certifique-se de que tem uma pasta para guardar os projetos de inquilinos. Tem de ter uma organização para criar pastas no projeto do produtor de serviços. Se não tiver uma pasta, siga as instruções em Criar e gerir pastas para criar uma. A sua pasta tem um FOLDER_ID baseado em números inteiros.
Na pasta, atribua a função Criador/eliminador de projetos à conta de serviço da API Service Consumer Management. Siga as instruções em Configurar o acesso a pastas para adicionar a função Criador do projeto e Eliminador do projeto, usando GCM_SA como o utilizador.
Definir autorizações da conta de faturação
Certifique-se de que tem uma conta de faturação que pode ser partilhada para projetos de inquilinos. Se não tiver uma conta de faturação, consulte o artigo Crie, modifique ou encerre uma conta de faturação para obter instruções sobre como criar uma.
Siga as instruções para adicionar a função de utilizador da conta de faturação a GCM_SA.
Requisitos de recursos
- A API Service Consumer Management cria projetos de inquilinos em seu nome, por isso, certifique-se de que tem quota suficiente para os criar.
- Consulte a documentação sobre os limites de projetos para saber quantos projetos podem ser criados por predefinição e para pedir aumentos a esse limite.