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 Google Cloud Console
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 utilisant des produits Google Cloud. Vous utilisez la console Google Cloud pour configurer et gérer les ressources Google Cloud 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 ressources Google Cloud. 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 ressources Google Cloud dans une hiérarchie des ressources. Pour en savoir plus sur les projets, consultez la documentation concernant Resource Manager.
Recommandation : Nous vous recommandons de configurer un seul projet Google Cloud distinct pour gérer vos exigences d'administration de la facturation, y compris l'API Cloud Billing Budget. Votre projet Google Cloud d'administration de la facturation peut également être utilisé pour l'accès à l'API Cloud Billing Account, aux données exportées Cloud Billing, aux canaux Pub/Sub pour les notifications de budget automatisées, etc.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
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 Google Cloud.
Un compte Cloud Billing sert à déterminer qui assume les frais pour un ensemble donné de ressources Google Cloud. 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 concernant la facturation.
Vous configurez des budgets Cloud Billing pour surveiller un compte Cloud Billing. Le compte Cloud Billing que vous surveillez peut être le même que le compte Cloud Billing associé au projet que vous utilisez pour appeler l'API Cloud Billing Budget. Notez que l'API Cloud Billing Budget est gratuite pour les clients Google Cloud. Si vous choisissez de configurer des notifications de budget automatisées, les tarifs Pub/Sub standards vous seront facturés.
Make sure that billing is enabled for your Google Cloud project.
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 Google Cloud.
Pour en savoir plus sur l'activation des API, consultez la documentation concernant Service Usage.
Enable the Cloud Billing Budget API.
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 la page 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 qui vous permet de gérer les ressources et les applications hébergées sur Google Cloud. Cela inclut gcloud CLI. Le lien suivant fournit les instructions correspondantes :
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init6. 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.