Avant de commencer à coder votre première application Cloud Billing Budget, vous devez effectuer les opérations suivantes (si ce n'est déjà fait).
Tester les fonctionnalités de Cloud Billing dans la console Google Cloud
Cette documentation de l'API suppose que vous avez utilisé Google Cloudet que vous maîtrisez les fonctionnalités et les concepts de Cloud Billing dans la console Google Cloud . Si vous n'êtes pas encore familiarisé avec les concepts tels que les comptes de facturation Cloud,les projets Google Cloud ,les produits Google Cloud, ainsi que les budgets et les alertes Cloud Billing, lisez les informations suivantes avant de commencer à coder :
- Présentation des concepts de Cloud Billing
- Gérer votre compte de facturation Cloud
- Voir les projets associés à un compte de facturation Cloud
- Présentation des budgets et des règles d'alertes de budget
- Gérer les budgets avec un plafond de dépenses
- Contrôle des accès à l'API Cloud Billing Budget
Une fois que vous connaissez les fonctionnalités et les concepts de Cloud Billing, essayez l'interface utilisateur de la consoleGoogle Cloud .
Concepts clés de Cloud Billing
- Chaque compte de facturation Cloud peut être associé à plusieurs milliers de budgets à la fois. Pour connaître les limites actuelles et d'autres informations, consultez la section Quotas et limites.
- Un budget n'est associé qu'à un seul compte de facturation Cloud à la fois.
- Un seul compte de facturation Cloud est associé à un ou plusieurs projetsGoogle Cloud et sert à payer ceux-ci.
- Un projet Google Cloud n'est associé qu'à un seul compte de facturation Cloud à la fois.
- Vous pouvez créer des budgets d'alertes uniquement pour surveiller les coûts de l'ensemble d'un compte de facturation Cloud, y compris tous les projets Google Cloud dont les frais sont assumés par ce compte de facturation. Vous pouvez également définir le champ d'application des budgets "Alertes uniquement" à l'aide de filtres de budget précis pour surveiller des tranches de coûts spécifiques. Les filtres incluent Google Cloudles projets, les services, la période du budget et d'autres filtres applicables à votre compte de facturation Cloud.
- Vous pouvez créer des budgets avec plafond de dépenses pour limiter vos dépenses pour un service éligible dans un Google Cloud projet spécifique. Lorsque le plafond de dépenses est appliqué, toute nouvelle utilisation du service dans le projet spécifié est suspendue jusqu'à ce que le plafond de dépenses soit levé.
Apprendre les bases de l'architecture REST
Il existe deux façons d'appeler l'API Cloud Billing Budget :
- Envoi de requêtes HTTP et analyse des réponses
- Utilisation de bibliothèques clientes (recommandé)
Si vous décidez de ne pas utiliser de bibliothèques clientes, vous devez comprendre les bases de l'architecture REST.
Il s'agit d'un style d'architecture logicielle qui permet de demander et modifier des données de manière pratique et cohérente.
Le terme REST est l'acronyme de REpresentational State Transfer. Dans le contexte des API Google, il désigne l'architecture utilisant des verbes HTTP pour récupérer et modifier les représentations des données stockées par Google.
Dans un système RESTful, les ressources sont stockées dans un datastore. Un client envoie une requête pour que le serveur exécute une action spécifique (par exemple la création, l'extraction, la mise à jour ou la suppression d'une ressource), et le serveur exécute l'action et envoie une réponse, souvent sous la forme d'une représentation de la ressource spécifiée.
Dans les API RESTful de Google, le client spécifie une action à l'aide d'un verbe HTTP comme POST, GET, PUT ou DELETE. La ressource est désignée par un URI unique au format suivant :
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Étant donné que toutes les ressources d'API possèdent des URI uniques accessibles via HTTP, REST permet la mise en cache des données, et son fonctionnement est optimisé pour l'infrastructure distribuée du Web.
Les définitions de méthode figurant dans la documentation du standard HTTP 1.1 peuvent s'avérer utiles, car elles incluent les spécifications pour GET, POST, PUT, et DELETE.
REST dans l'API Cloud Billing Budget
Les opérations de l'API Cloud Billing Budget correspondent exactement aux verbes HTTP REST.
Les formats spécifiques des URI de l'API Cloud Billing Budget sont les suivants :
https://billingbudgets.googleapis.com/v1/resourcePath?parameters
L'ensemble complet des URI utilisés pour chaque opération compatible avec l'API est récapitulé dans la documentation de référence REST de l'API Cloud Billing Budget.
Apprendre les bases du format JSON
L'API Cloud Billing Budget renvoie les données au format JSON.
JSON (JavaScript Object Notation) est un format de données qui ne dépend pas d'un langage et qui fournit une représentation textuelle simple de structures de données arbitraires. Pour en savoir plus, accédez à json.org.