Bevor Sie mit dem Coding Ihrer ersten Cloud Billing-Budgetanwendung beginnen, müssen Sie einige Vorbereitungen treffen, falls noch nicht geschehen.
Cloud Billing-Features in der Google Cloud Console testen
In dieser API-Dokumentation wird davon ausgegangen, dass Sie Google Cloudverwendet haben und mit den Features und Konzepten von Cloud Billing in der Google Cloud Console vertraut sind. Wenn Sie mit Konzepten wie Cloud-Rechnungskonten, Google Cloud Projekten, Google CloudProdukten sowie Cloud Billing-Budgets und -Benachrichtigungen noch nicht vertraut sind, lesen Sie folgende Dokumente zur Abrechnung, bevor Sie mit dem Programmieren beginnen:
- Cloud Billing-Konzepte
- Cloud-Rechnungskonto verwalten
- Mit einem Cloud-Rechnungskonto verknüpfte Projekte ansehen
- Budgets und Budgetbenachrichtigungsregeln
- Budgets mit Ausgabenlimit verwalten
- Zugriffssteuerung für die Cloud Billing Budget API
Nachdem Sie sich mit den Features und Konzepten von Cloud Billing vertraut gemacht haben, sehen Sie sich die Google Cloud Console-Benutzeroberfläche an.
Wichtige Cloud Billing-Konzepte
- Jedes einzelne Cloud-Rechnungskonto kann gleichzeitig mit mehreren Tausend Budgets verknüpft sein. Die aktuellen Limits und weitere Informationen finden Sie unter Kontingente und Limits.
- Ein Budget ist jeweils nur mit einem Cloud-Rechnungskonto verknüpft.
- Ein einzelnes Cloud-Rechnungskonto ist mit einem oder mehrerenGoogle Cloud Projekten verknüpft und wird zu deren Abrechnung verwendet.
- Ein Google Cloud Projekt ist jeweils nur mit einem Cloud-Rechnungskonto verknüpft.
- Sie können Budgets nur für Benachrichtigungen erstellen, um Ihre Kosten für ein komplettes Cloud-Rechnungskonto im Blick zu behalten, einschließlich aller Google Cloud Projekte, die über dieses Rechnungskonto bezahlt werden. Sie können den Umfang von Budgets, die nur Benachrichtigungen auslösen, auch mithilfe von detaillierten Budgetfiltern definieren, um bestimmte Kostenbereiche zu beobachten. Filter umfassen Google CloudProjekte, Dienste, den Budgetzeitraum des Budgets und andere Filter, die für Ihr Cloud-Rechnungskonto gelten.
- Sie können Budgets mit Ausgabenobergrenze erstellen, um Ihre Ausgaben für einen berechtigten Dienst in einem bestimmten Google Cloud Projekt zu begrenzen. Wenn die Ausgabenobergrenze erzwungen wird, wird die neue Nutzung des Dienstes im angegebenen Projekt pausiert, bis die Ausgabenobergrenze aufgehoben wird.
Informationen zu REST-Grundlagen
Zum Aufrufen der Cloud Billing Budget API gibt es zwei Möglichkeiten:
- HTTP-Anfragen senden und die Antworten parsen
- Clientbibliotheken nutzen (empfohlen)
Wenn Sie keine Clientbibliotheken verwenden möchten, benötigen Sie grundlegende REST-Kenntnisse.
REST ist eine Art Softwarearchitektur, die einen bequemen und einheitlichen Ansatz zur Abfrage und Bearbeitung von Daten bietet.
Der Begriff REST steht für Representational State Transfer. Im Zusammenhang mit Google-APIs bezieht es sich auf die Verwendung von HTTP-Verben zum Abrufen und Ändern von Darstellungen von Daten, die von Google gespeichert sind.
In einem als "RESTful" bezeichneten System werden Ressourcen in einem Datenspeicher abgelegt; ein Client sendet eine Aufforderung, der Server möge eine bestimmte Aktion ausführen (z. B. eine Ressource erstellen, abfragen, aktualisieren oder löschen), und der Server führt die Aktion aus und sendet eine Antwort, oft in Form einer Darstellung der angegebenen Ressource.
In den RESTful APIs von Google spezifiziert der Client eine Aktion mit einem HTTP-Verb wie POST, GET, PUT oder DELETE. Eine Ressource wird anhand eines weltweit eindeutigen URIs im folgenden Format spezifiziert:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Weil alle API-Ressourcen eindeutige, über HTTP zugängliche URIs haben, ermöglicht REST das Caching von Daten und ist optimal geeignet, mit der verteilten Infrastruktur des Webs zu arbeiten.
Dafür können die Methodendefinitionen in der Dokumentation der HTTP 1.1-Standards hilfreich sein. Hier finden Sie auch die Spezifikationen für GET, POST, PUT und DELETE.
REST in der Cloud Billing Budget API
Die Cloud Billing Budget API-Vorgänge sind REST HTTP-Verben direkt zugeordnet.
Für Cloud Billing Budget API-URIs gelten folgende spezielle Formate:
https://billingbudgets.googleapis.com/v1/resourcePath?parameters
Eine vollständige Liste der URIs für jeden unterstützten Vorgang in der API finden Sie in den REST-Referenzdokumenten zur Cloud Billing Budget API.
Informationen zu JSON-Grundlagen
Die Cloud Billing Budget API gibt Daten im JSON-Format zurück.
JSON (JavaScript Object Notation) ist ein gängiges sprachunabhängiges Datenformat, das eine einfache Textdarstellung beliebiger Datenstrukturen bietet. Weitere Informationen finden Sie unter json.org.