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 projet Google 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 console Google 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 :
service-PROJECT_NUMBER@service-consumer-management.iam.gserviceaccount.com
où PROJECT_NUMBER désigne le numéro de votre projet producteur de services qui a activé le service Service Consumer Management.
Dans la suite du présent guide, le compte de service de l'API Service Consumer Management est représenté par GCM_SA.
Vous pouvez utiliser les commandes suivantes pour générer l'identité du service.
- Connectez-vous avec votre compte utilisateur.
gcloud auth login
- Générez l'identité du service.
gcloud beta services identity create --service=serviceconsumermanagement.googleapis.com --project=PROJECT_ID
Définir des autorisations pour les dossiers
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.