Diese Anleitung enthält alle erforderlichen Einrichtungsschritte für die erstmalige Nutzung der Cloud Billing Budget API.
Vorbereitung
Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:
- Lesen Sie die Übersicht zur Cloud Billing Budget API.
- Lesen Sie Cloud Billing Budget API – Voraussetzungen.
Informationen zur Google Cloud Console
Die Google Cloud Console (Dokumentation ansehen, Console öffnen) ist eine Web-UI zur Bereitstellung, Konfiguration, Verwaltung und Überwachung von Systemen, die Google Cloud-Produkte verwenden. Die Google Cloud- und Cloud Billing-Ressourcen werden in der Google Cloud Console eingerichtet und verwaltet.
1. Projekt auswählen oder erstellen
Wenn Sie Dienste von Google Cloud nutzen möchten, müssen Sie ein Projekt erstellen. Es dient zur Organisation all Ihrer Google Cloud-Ressourcen. Ein Projekt umfasst Mitarbeiter, aktivierte APIs (und andere Ressourcen), Monitoringtools, Zahlungsinformationen sowie Authentifizierungs- und Zugriffssteuerungen. Sie können wahlweise ein Projekt erstellen oder Ihre Google Cloud-Ressourcen durch Erstellen mehrerer Projekte in einer Ressourcenhierarchie organisieren. Weitere Informationen zu Projekten finden Sie in der Dokumentation zu Resource Manager.
Empfehlung: Wir empfehlen Ihnen, ein einzelnes, separates Google Cloud-Projekt zu konfigurieren, das alle Ihre Anforderungen an die Abrechnungsverwaltung einschließlich der Cloud Billing Budget API enthält. Ihr Google Cloud-Projekt für die Abrechnungsverwaltung kann darüber hinaus für verschiedene Dinge verwendet werden, wie z. B. den Zugriff auf die Cloud Billing Account API, exportierte Cloud Billing-Daten, Pub/Sub-Kanäle für programmatische Budgetbenachrichtigungen usw.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
2. Abrechnung aktivieren
Die Abrechnung muss für das Projekt, das Sie zum Aufrufen der Cloud Billing Budget API verwenden, aktiviert sein. Wenn Sie der Empfehlung im Projektbereich gefolgt sind, ist dies Ihr Google Cloud-Projekt für die Abrechnungsverwaltung.
Mit einem Cloud-Rechnungskonto wird festgelegt, wer für eine bestimmte Gruppe von Google Cloud-Ressourcen bezahlt. Ressourcen wie aktivierte APIs sind in Projekten organisiert. Ein Cloud-Rechnungskonto kann mit einem oder mehreren Projekten verknüpft sein. Die Gebühren für die Projektnutzung werden dem verknüpften Rechnungskonto belastet. In den meisten Fällen konfigurieren Sie die Abrechnung beim Erstellen eines Projekts. Weitere Informationen finden Sie in der Dokumentation zur Abrechnung.
Sie richten Cloud Billing-Budgets ein, um ein Cloud-Rechnungskonto zu beobachten. Das von Ihnen beobachtete Cloud-Rechnungskonto kann dasselbe Cloud-Rechnungskonto sein, das mit dem Projekt verknüpft ist, das Sie zum Aufrufen der Cloud Billing Budget API verwenden. Die Nutzung der Cloud Billing Budget API ist für Google Cloud-Kunden kostenlos. Wenn Sie programmatische Budgetbenachrichtigungen konfigurieren, werden Ihnen die Pub/Sub-Standardpreise berechnet.
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
3. API aktivieren
Sie müssen die Cloud Billing Budget API in dem Projekt aktivieren, mit dem Sie die Cloud Billing Budget API aufrufen. Wenn Sie der Empfehlung im Projektbereich gefolgt sind, ist dies Ihr Google Cloud-Projekt für die Abrechnungsverwaltung.
Weitere Informationen zur Aktivierung von APIs finden Sie in der Dokumentation zu Service Usage.
Enable the Cloud Billing Budget API.
4. Authentifizierung und Autorisierung einrichten
Wenn Sie die Cloud Billing Budget API verwenden möchten, müssen Sie die Authentifizierung einrichten. Jede Client-Anwendung, die die API verwendet, muss ihre Identität durch Authentifizierung bestätigen. Weitere Informationen finden Sie unter Bei Cloud Billing authentifizieren.
Sie authentifizieren sich als ein bestimmtes Hauptkonto, z. B. ein Google-Konto oder ein Dienstkonto. Dieses Hauptkonto muss IAM-Rollen (Identity and Access Management) haben, die die erforderlichen Berechtigungen für die Cloud Billing Budget API enthalten.
Damit das Hauptkonto die erforderlichen Berechtigungen zum Verwalten von Budgets hat, bitte Sie den Administrator, dem Hauptkonto die IAM-Rolle Billing Account Administrator (roles/billing.admin) zuzuweisen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Ihr Administrator kann dem Hauptkonto möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.
Informationen zum Zuweisen von Rollen für ein Rechnungskonto finden Sie unter Cloud Billing-Berechtigungen aktualisieren.
5. gcloud CLI installieren und initialisieren
Wenn Sie die Cloud Billing Budget API verwenden möchten, müssen Sie das Google Cloud CLI installieren und initialisieren. Die Google Cloud CLI umfasst mehrere Tools, mit denen Sie auf Google Cloud gehostete Ressourcen und Anwendungen verwalten können. Dazu gehört auch die gcloud-CLI. Unter folgendem Link finden Sie eine Anleitung:
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init6. SDK und Authentifizierung testen
Wenn Sie in den vorangegangenen Schritten die Authentifizierung eingerichtet haben, können Sie Ihre Authentifizierungsumgebung mit dem gcloud CLI testen. Führen Sie folgenden Befehl aus und vergewissern Sie sich, dass kein Fehler auftritt und dass Anmeldedaten zurückgegeben werden:
gcloud auth print-access-token
Dieser Befehl wird in allen REST-Beispielen für die Cloud Billing Budget API-Befehlszeile verwendet, um API-Aufrufe zu authentifizieren.
7. Cloud Billing Budget API-Clientbibliothek installieren
Die Cloud Billing Budget API basiert auf HTTP und JSON. Daher kann jeder Standard-HTTP-Client Anfragen an sie senden und die Antworten parsen.
Zum Aufrufen der API haben Sie drei Möglichkeiten:
Von Google unterstützte Clientbibliotheken (empfohlen)
Clientbibliotheken bieten eine bessere Sprachintegration sowie eine höhere Sicherheit und unterstützen auch Aufrufe, die eine Nutzerautorisierung erfordern. Die von Google unterstützten Clientbibliotheken sind für verschiedene gängige Sprachen verfügbar. Dies ist die empfohlene Option.