Ce guide fournit toutes les étapes de configuration requises pour commencer à utiliser l'API Cloud Billing Budget.
Avant de commencer
Avant de lire ce guide, procédez comme suit :
- Consultez la section Présentation de l'API Cloud Billing Budget.
- Consultez la section Conditions préalables à l'utilisation de l'API Cloud Billing Budget.
À propos de la Google Cloud console
La Google Cloud console (accéder à la documentation, ouvrir la console) est une interface utilisateur Web permettant de provisionner, configurer, gérer et surveiller les systèmes qui utilisent Google Cloud des produits. Vous utilisez la Google Cloud console pour configurer et gérer Google Cloud les ressources et Cloud Billing.
1. Sélectionner ou créer un projet
Pour utiliser les services fournis par Google Cloud, vous devez créer un projet. Un projet permet d'organiser toutes vos Google Cloud ressources. Il se compose d'un ensemble de collaborateurs, d'API activées (et d'autres ressources), d'outils de surveillance, d'informations de facturation, et de contrôles d'authentification et d'accès. Vous pouvez créer un projet, ou en créer plusieurs et les utiliser pour organiser vos Google Cloud ressources dans une hiérarchie des ressources. Pour en savoir plus sur les projets, consultez la documentation concernant Resource Manager.
Recommandation concernant les projets : Nous vous recommandons de créer et d'utiliser un projet distinct Google Cloud pour contenir tous vos besoins d'administration FinOps et de facturation pour un compte de facturation Cloud, y compris votre utilisation de l'API Cloud Billing Budget. Découvrez les avantages d'un projet axé sur FinOps pour vos propres cas d'administration de la facturation.
Dans la Google Cloud console, sur la page de sélection du projet, sélectionnez ou créez un Google Cloud projet.
Rôles requis pour sélectionner ou créer un projet
- Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
-
Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet
(
roles/resourcemanager.projectCreator), qui contient l'autorisationresourcemanager.projects.create. Découvrez comment attribuer des rôles.
Accéder au sélecteur de projet
2. Activer la facturation
Vous devez vous assurer que la facturation est activée sur le projet que vous utilisez pour appeler l'API Cloud Billing Budget. Si vous avez suivi la recommandation dans la section Sélectionner ou créer un projet, il s'agit de votre projet d'administration de la facturation ou de FinOps Google Cloud .
Vérifiez que la facturation est activée pour votre Google Cloud projet.
Un compte de facturation Cloud sert à déterminer qui assume les frais pour un ensemble donné de Google Cloud ressources. Les ressources, telles que les API activées, sont organisées dans des projets. Un compte de facturation Cloud peut être associé à un ou plusieurs projets. Les frais d'utilisation du projet sont imputés au compte de facturation associé. Dans la plupart des cas, vous configurez la facturation lorsque vous créez un projet. Pour en savoir plus, consultez la documentation Cloud Billing.
Coût d'utilisation
Vous configurez des budgets Cloud Billing pour surveiller les coûts générés dans un compte de facturation Cloud. Le compte de facturation Cloud que vous surveillez peut être le même compte de facturation Cloud qui est associé au projet que vous utilisez pour appeler l'API Cloud Billing Budget. Notez que l'API Cloud Billing Budget est sans frais pour Google Cloud les clients. Si vous choisissez de configurer des notifications de budget automatisées, les tarifs Pub/Sub standardsvous seront facturés.
3. Activer l'API
Vous devez activer l'API Cloud Billing Budget dans le projet que vous utilisez pour appeler l'API Cloud Billing Budget. Si vous avez suivi la recommandation dans la section Sélectionner ou créer un projet, il s'agit de votre projet d'administration de la facturation ou de FinOps Google Cloud .
Pour en savoir plus sur l'activation des API, consultez la documentation concernant Service Usage.
Activez l'API Cloud Billing Budget.
Rôles requis pour activer les API
Pour activer les API, vous avez besoin du rôle IAM Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin), qui
contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer
des rôles.
4. Configurer l'authentification et l'autorisation
Si vous prévoyez d'utiliser l'API Cloud Billing Budget, vous devez configurer l'authentification. Toute application cliente qui utilise l'API doit confirmer son identité en s'authentifiant. Pour en savoir plus, consultez S'authentifier auprès de Cloud Billing.
Vous vous authentifiez en tant que compte principal spécifique, tel qu'un compte Google ou un compte de service. Ce compte principal doit disposer de rôles Identity and Access Management (IAM) contenant les autorisations requises pour l'API Cloud Billing Budget.
Pour vous assurer que le compte principal dispose des autorisations nécessaires pour gérer les budgets, demandez à votre administrateur de lui attribuer le rôle IAM d'Administrateur de compte de facturation (roles/billing.admin) pour votre compte de facturation.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Votre administrateur peut également attribuer au compte principal les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Pour savoir comment attribuer des rôles à un compte de facturation, consultez la page Mettre à jour les autorisations Cloud Billing.
5. Installer et initialiser gcloud CLI
Si vous prévoyez d'utiliser l'API Cloud Billing Budget, vous devez installer et initialiser Google Cloud CLI. Google Cloud CLI est un ensemble d'outils que vous pouvez utiliser pour gérer les ressources et les applications hébergées sur Google Cloud. Cela inclut gcloud CLI. Le lien suivant fournit des instructions :
Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisezla en exécutant la commande suivante :
gcloud initSi vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
6. Tester le SDK et s'authentifier
Si vous avez configuré l'authentification lors des étapes précédentes, vous pouvez utiliser gcloud CLI pour tester votre environnement d'authentification. Exécutez la commande suivante pour vérifier qu'aucune erreur ne se produit et que les identifiants sont bien renvoyés :
gcloud auth print-access-token
Cette commande est utilisée par tous les exemples REST en ligne de commande de l'API Cloud Billing Budget afin d'authentifier les appels d'API.
7. Installer la bibliothèque cliente de l'API Cloud Billing Budget
L'API Cloud Billing Budget est basée sur HTTP et JSON. Par conséquent, n'importe quel client HTTP standard peut lui envoyer des requêtes et analyser ses réponses.
Vous disposez des trois options suivantes pour appeler l'API :
Bibliothèques clientes compatibles avec Google (recommandé)
Les bibliothèques clientes permettent d'intégrer plus facilement les langages de programmation, d'améliorer la sécurité et d'accepter les appels nécessitant des privilèges utilisateur. Les bibliothèques clientes compatibles avec Google sont disponibles dans plusieurs langages courants, et sont l'option recommandée.