Primeiros passos com a API Service Consumer Management

Esta página descreve as etapas que precisam ser concluídas antes que você possa começar a usar a API Service Consumer Management. Presumimos que você já tenha um projeto do Google Cloud, um serviço gerenciado (como um serviço gerenciado criado usando o Cloud Endpoints) nesse projeto e que você entenda Unidades de locação.

Como ativar o serviço

Além de ajudar você a gerenciar o uso dos próprios serviços gerenciados, a API Service Consumer Management também é um serviço. Portanto, antes de poder usá-lo, você deve ativar a API Service Consumer Management do projeto Google Cloud que hospeda o serviço gerenciado. Esse projeto é chamado de projeto de produtor de serviço.

A maneira mais simples de ativar a API Service Consumer Management para o projeto de produtor de serviços é usar o console do Google Cloud. Como alternativa, você pode ativá-la na linha de comando ou programaticamente. Saiba mais em Como ativar e desativar serviços.

Como definir permissões

Depois que a API Service Consumer Management estiver ativada para o projeto de produtor de serviço, crie sua identidade de serviço pessoal e conceda a ela permissões aos recursos para que ela possa criar projetos de locatário nas pastas e configure a conta de cobrança correta nos projetos de locatário. Essas ações são executadas por uma conta de serviço de propriedade da API Service Consumer Management, que é especificada no seguinte formato:

service-PROJECT_NUMBER@service-consumer-management.iam.gserviceaccount.com

em que PROJECT_NUMBER é o número do projeto de produtor de serviços que ativou o serviço Service Consumer Management.

O restante deste guia usa GCM_SA para representar a conta de serviço da API Service Consumer Management

Você pode usar os seguintes comandos para gerar a identidade do serviço.

  1. Entre com sua conta de usuário.
gcloud auth login
  1. Gere a identidade de serviço.
gcloud beta services identity create --service=serviceconsumermanagement.googleapis.com --project=PROJECT_ID

Como definir permissões de pasta

  1. Assegure-se de ter uma pasta para manter seus projetos de locatário: você precisará ter uma organização para criar pastas em seu projeto de produtor de serviço. Se não tiver uma pasta, siga as instruções em Como criar e gerenciar pastas para criar uma. Sua pasta terá um número inteiro baseado em FOLDER_ID.

  2. Na pasta, atribua o papel de criador/excluidor do projeto à conta de serviço da API Service Consumer Management. Siga as instruções em Como configurar o acesso a pastas para adicionar os papéis Criador de projeto e Excluidor de projeto, usando GCM_SA como o usuário.

Como definir permissões da conta de faturamento

  1. Certifique-se de ter uma conta de faturamento para projetos de locatário que possa ser compartilhada. Se você não tiver uma conta de faturamento, consulte Criar, modificar ou encerrar uma conta de faturamento para instruções sobre como criar uma.

  2. Siga as instruções para adicionar o papel Usuário da conta de cobrança ao GCM_SA.

Recursos necessários

  • A API Service Consumer Management cria projetos de locação para você. Portanto, certifique-se de ter cota suficiente para criá-los.
  • Consulte a documentação de limites do projeto para saber quantos projetos podem ser criados por padrão e solicitar o aumento desse limite.