Premiers pas avec l'API Service Consumer Management
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit la procédure à suivre avant de commencer à utiliser l'API Service Consumer Management. Il est considéré que vous disposez déjà d'un projetGoogle Cloud et d'un service géré (créé à l'aide de Cloud Endpoints, par exemple), et que vous comprenez le concept des unités de location.
Activer le service
Bien que l'API Service Consumer Management vous aide à gérer l'utilisation de vos propres services gérés, elle est elle-même un service. Par conséquent, avant de pouvoir l'utiliser, vous devez activer l'API Service Consumer Management pour le projet Google Cloud qui héberge votre service géré. Ce projet est appelé un projet producteur de services.
Le moyen le plus simple d'activer l'API Service Consumer Management pour votre projet producteur de services consiste à utiliser la consoleGoogle Cloud .
Vous pouvez également l'activer à partir de l'outil de ligne de commande ou de manière automatisée. Pour en savoir plus, consultez la page Activer et désactiver des services.
Définir des autorisations
Une fois que l'API Service Consumer Management est activée pour votre projet producteur de services, vous devez créer votre propre identité de service, puis accorder à l'API des autorisations sur vos ressources afin qu'elle puisse créer des projets locataires dans vos dossiers et configurer le bon compte de facturation sur les projets locataires. Ces actions sont exécutées par un compte de service détenu par l'API Service Consumer Management, spécifié au format suivant :
Assurez-vous de disposer d'un dossier pour vos projets locataires : pour créer des dossiers dans votre projet producteur de services, vous devez disposer d'une organisation. Si vous n'avez pas de dossier, suivez les instructions de la page Créer et gérer des dossiers pour en créer un. Le FOLDER_ID de votre dossier sera un nombre entier.
Dans votre dossier, attribuez le rôle Créateur de projet/Outil de suppression de projets au compte de service de l'API Service Consumer Management. Suivez les instructions de la page Configurer l'accès aux dossiers pour ajouter les rôles Créateur de projet et Outil de suppression de projets, en définissant GCM_SA comme utilisateur.
Définir des autorisations pour le compte de facturation
Assurez-vous de disposer d'un compte de facturation pouvant être partagé pour les projets locataires. Si vous n'avez pas de compte de facturation, consultez la page Créer, modifier ou fermer un compte de facturation pour savoir comment le créer.
Suivez les instructions pour ajouter le rôle Utilisateur de compte de facturation à GCM_SA.
Ressources nécessaires
L'API Service Consumer Management crée des projets locataires en votre nom. Assurez-vous donc de disposer d'un quota d'utilisation suffisant pour les créer.
Consultez la documentation sur les limites de projets pour savoir combien de projets peuvent être créés par défaut et demander des augmentations à cette limite.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (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."]]
