Primeiros passos com a API Service Consumer Management
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 projetoGoogle Cloud e um serviço gerenciado (como um serviço gerenciado criado usando o Cloud Endpoints) nesse projeto e que você entenda as 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 é conhecido como 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
consoleGoogle 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:
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.
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
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.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 UTC."],[],[],null,["# Getting Started with the Service Consumer Management API\n\nThe page describes the steps that need to be completed before you\ncan start to use the Service Consumer Management API. It assumes that you already have a\nGoogle Cloud project and a [managed service](/service-infrastructure/docs/glossary#managed)\n(such as a managed service created using [Cloud Endpoints](/endpoints/docs)) in\nthat project, and that you understand\n[Tenancy Units](/service-infrastructure/docs/glossary#tenancy).\n\nActivating the service\n----------------------\n\nWhile the Service Consumer Management API helps you to manage the usage of your own\n[managed services](/service-infrastructure/docs/glossary#managed), it is also a service\nitself. Therefore, before you can use it, you must activate the\nService Consumer Management API for the Google Cloud project that hosts your managed\nservice. This project is known as a [service producer](/service-infrastructure/docs/glossary#producer)\nproject.\n\nThe simplest way to enable the Service Consumer Management API for your service\nproducer project is to use the\n[Google Cloud console](https://console.cloud.google.com/apis/api/serviceconsumermanagement.googleapis.com).\nAlternatively, you can enable it from the command line or programmatically. You\ncan find out more in\n[Enabling and Disabling Services](/service-usage/docs/enable-disable).\n\nSetting permissions\n-------------------\n\nAfter the Service Consumer Management API is enabled for your service producer\nproject, you must create your own service identity and grant it permissions on\nyour resources so that it can create [tenant projects](/service-infrastructure/docs/glossary#tenant) in\nyour folders and set up the correct billing account on tenant projects. These\nactions are executed by a service account owned by the Service Consumer Management\nAPI, which is specified in the following format: \n\n```\nservice-PROJECT_NUMBER@service-consumer-management.iam.gserviceaccount.com\n```\n\nwhere *PROJECT_NUMBER* is the project number for your service producer project\nthat activated the Service Consumer Management service.\n\nThe remainder of this guide uses *GCM_SA* to represent the\nService Consumer Management API service account.\n\nYou can use the following commands to generate the service identity.\n\n1. Login with your user account.\n\n```\ngcloud auth login\n```\n\n1. Generate the service identity.\n\n```\ngcloud beta services identity create --service=serviceconsumermanagement.googleapis.com --project=PROJECT_ID\n```\n\n### Setting folder permissions\n\n1. Ensure that you have a folder for holding your tenant projects: you'll need\n to have an [Organization](/resource-manager/docs/creating-managing-organization)\n to create folders within your service producer project. If you don't have a\n folder, follow the instructions in\n [Creating and Managing Folders](/resource-manager/docs/creating-managing-folders#create-folder)\n to create one. Your folder will have an integer based *FOLDER_ID*.\n\n2. On your folder, assign the **Project Creator/Deleter** role to the\n Service Consumer Management API service account. Follow the instructions in\n [Configuring Access to Folders](/resource-manager/docs/creating-managing-folders#configuring_access_to_folders)\n to add the **Project Creator** and **Project Deleter** role, using *GCM_SA* as\n the user.\n\n### Setting billing account permissions\n\n1. Ensure that you have a billing account that can be shared for tenant\n projects. If you don't have a billing account, see\n [Create, Modify, or Close a Billing Account](/billing/docs/how-to/manage-billing-account)\n for instructions to create one.\n\n2. Follow the\n [instructions](/billing/docs/how-to/billing-access)\n to add the **Billing Account User** role to *GCM_SA*.\n\nResource requirements\n---------------------\n\n- The Service Consumer Management API creates [tenant projects](/service-infrastructure/docs/glossary#tenant) on your behalf, so ensure you have enough quota to create them.\n- See the [project limits](https://cloud.google.com/resource-manager/docs/limits#project-limits) documentation to know how many projects can be created by default and to request increases to that limit."]]
