Hier erfahren Sie, wie Sie einige einfache Anfragen an die Cloud Billing Budget API senden.
Eine vollständige Liste der Methoden finden Sie in der REST API-Referenzdokumentation.
Hinweis
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.
- Einrichtungsschritte ausführen
ID des Cloud-Rechnungskonto identifizieren
Für jeden Cloud Billing Budget API-Aufruf benötigen Sie die ID des Cloud-Rechnungskontos.
- Rufen Sie die Google Cloud Console-Seite „Rechnungskonten verwalten“ auf.
- Im Tab Meine Rechnungskonten wird die Liste der Cloud-Rechnungskonten nach Name und ID sortiert angezeigt. Suchen Sie den Wert für die Konto-ID des Kontos, in dem Sie Budgets verwalten.

Wichtige Budgetkonzepte
- Ein Nur-Benachrichtigungen-Budget kann auf ein gesamtes Rechnungskonto angewendet oder mithilfe von detaillierten Budgetfiltern eingegrenzt (gefiltert) werden, um bestimmte Kostenbereiche zu beobachten.
- Ein Nur-Benachrichtigungen-Budget, das für ein gesamtes Cloud-Rechnungskonto gilt, umfasst die Kosten aller Google Cloud -Projekte, die über dieses Rechnungskonto bezahlt werden.
- Wenn Sie nur eingeschränkten oder keinen Zugriff auf das Cloud-Rechnungskonto haben, können Sie Budgets für einzelne Projekte für ihre eigenen Projekte erstellen. Wenn Sie ein Nutzer auf Cloud-Rechnungskonto-Ebene sind, können Sie Nur-Benachrichtigungen-Budgets für einzelne Projekte erstellen, die nicht von Nutzern auf Projektebene mit dem Feld
OwnershipScopeim Budget geändert werden können. - Sie können den Umfang eines Nur-Benachrichtigungen-Budgets mithilfe von Filtern eingrenzen, z. B. auf eine Teilmenge von Organisationen, Ordnern, Projekten, Diensten und anderen Budgetfiltern, die für Ihr Cloud-Rechnungskonto gelten.
- Sie können den Zeitraum eines Nur-Benachrichtigungen-Budgets angeben. Standardmäßig werden mit einem Budget die Kosten überwacht, die während eines Kalendermonats anfallen. Mit dem Filter
usage_period, der in der Cloud Billing Budget API verfügbar ist, können Sie den Zeitraum eines Nur-Benachrichtigungen-Budgets auf einenCalendarPeriododer einenCustomPeriodkonfigurieren. So können Sie Nur-Benachrichtigungen-Budgets erstellen, um Zeiträume über den Standardkalendermonat hinaus zu überwachen, z. B. ein Quartal, ein Jahr oder einen von Ihnen angegebenen benutzerdefinierten Datumsbereich. - Bei Nur-Benachrichtigungen-Budgets können Sie den Budgetbetrag auf einen von Ihnen angegebenen Betrag festlegen oder den Budgetbetrag auf die Ausgaben des vorherigen Kalenderzeitraums basieren.
- Sie können Budgetschwellenwert-Regeln festlegen, um E-Mail-Benachrichtigungen auszulösen. Wenn Ihre Kosten (tatsächliche Kosten oder prognostizierte Kosten) einen Prozentsatz Ihres Budgets überschreiten, der auf den von Ihnen festgelegten Regeln basiert, werden Benachrichtigungs-E-Mails an die angegebenen Empfänger gesendet.
- Für Nur-Benachrichtigungen-Budgets können Sie die Benachrichtigungsregeln des Budgets festlegen, um die E‑Mail-Empfänger von Budgetbenachrichtigungen anzugeben und programmatische Benachrichtigungen mit Pub/Sub zu aktivieren.
- Für Nur-Benachrichtigungen-Budgets können Sie Pub/Sub-Themen für programmatische Benachrichtigungen verwenden, um beispielsweise Ihre Budgetnachrichten an andere Medien wie Slack weiterzuleiten oder Kostenverwaltungsaufgaben zu automatisieren.
Kontingentlimit: Jedes einzelne Cloud-Rechnungskonto kann mehrere Tausend Budgets haben, mit dem es verknüpft ist. Aktuelle Limits und weitere Informationen finden Sie unter Kontingente und Limits.
API aufrufen
Die folgenden Beispiele zeigen, wie Sie einige einfache Anfragen an die Cloud Billing Budget API senden.
Budgets auflisten
Diese API-Methode listet alle für ein bestimmtes Cloud-Rechnungskonto verfügbaren Budgets auf.
REST
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
- billing-account-id: Die ID des Cloud-Rechnungskonto, auf das sich die Budgets beziehen.
- project-id: Das Google Cloud -Projekt, in dem die Cloud Billing Budget API aktiviert ist.
HTTP-Methode und URL:
GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"budgets": [
{
"name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
"displayName": "Forecasted spend budget with Service Filter",
"budgetFilter": {
"projects": [
"projects/123456789"
],
"services": [
"services/A1E8-BE35-7EBC"
],
"creditTypesTreatment": "EXCLUDE_ALL_CREDITS",
"calendarPeriod": "MONTH"
},
"amount": {
"lastPeriodAmount": {}
},
"thresholdRules": [
{
"thresholdPercent": 0.9,
"spendBasis": "FORECASTED_SPEND"
}
],
"allUpdatesRule": {},
"etag": "c9d6c011f6fa6b5c"
}
]
}
Budget abrufen
Diese API-Methode ruft die Details für ein bestimmtes Budget ab.
REST
Um diese Methode aufzurufen, benötigen Sie den budget-id des Budgets, das Sie aktualisieren möchten. Sie können die Budget-ID aus der Ausgabe createBudget erhalten, wenn Sie Ihr Budget erstellen, oder aus der Ausgabe listBudgets, wenn Sie alle Ihre Budgets auflisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- billing-account-id: Die ID des Cloud-Rechnungskonto, auf das sich das Budget bezieht.
- budget-id: Die ID des Budgets, das Sie abrufen möchten.
- project-id: Das Google Cloud -Projekt, in dem die Cloud Billing Budget API aktiviert ist.
HTTP-Methode und URL:
GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
"displayName": "Forecasted spend budget with Service Filter",
"budgetFilter": {
"projects": [
"projects/123456789"
],
"services": [
"services/A1E8-BE35-7EBC"
],
"creditTypesTreatment": "EXCLUDE_ALL_CREDITS",
"calendarPeriod": "MONTH"
},
"amount": {
"lastPeriodAmount": {}
},
"thresholdRules": [
{
"thresholdPercent": 0.9,
"spendBasis": "FORECASTED_SPEND"
}
],
"allUpdatesRule": {},
"etag": "c9d6c011f6fa6b5c"
}
Budget erstellen
Diese API-Methode erstellt ein Cloud Billing-Budget nur für Benachrichtigungen, das sich auf das angegebene Cloud-Rechnungskonto bezieht.
REST
In diesem Beispiel wird gezeigt, wie Sie ein Budget für ein bestimmtes Cloud-Rechnungskonto erstellen, das auf ein von Ihnen angegebenes Google Cloud -Projekt begrenzt (gefiltert) und für den Kalenderzeitraum eines Quartals festgelegt ist.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
projects/budget-scope-project-id: Die Google Cloud -Projekt-ID, die Sie als Budgetumfang (budgetFilter) festlegen möchten.- billing-account-id: Die ID des Cloud-Rechnungskonto, auf das sich das Budget bezieht.
- api-user-project-id: Das Google Cloud -Projekt, in dem die Cloud Billing Budget API aktiviert ist.
HTTP-Methode und URL:
POST https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets
JSON-Text anfordern:
{
"displayName": "Keep my spending down",
"budgetFilter": {
"projects": [
"projects/budget-scope-project-id"
],
"calendar_period": "QUARTER"
},
"amount": {
"lastPeriodAmount": {}
},
"thresholdRules": {
"thresholdPercent": 0.8,
"spendBasis": "CURRENT_SPEND"
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
"displayName": "Keep my spending down",
"budgetFilter": {
"projects": [
"projects/123456789"
],
"creditTypesTreatment": "INCLUDE_ALL_CREDITS",
"calendar_period": "QUARTER"
},
"amount": {
"lastPeriodAmount": {}
},
"thresholdRules": {
"thresholdPercent": 0.8,
"spendBasis": "CURRENT_SPEND"
},
"allUpdatesRule": {},
"etag": "f7928d8010160668"
}
Budget aktualisieren
Verwenden Sie diese API-Methode, um ein vorhandenes Cloud Billing-Budget zu bearbeiten und den Budgetbetrag, die Budgetfilter (Budgetumfang), den Budgetzeitraum oder die Schwellenwertregeln zu ändern.
REST
In diesem Beispiel wird gezeigt, wie Sie ein vorhandenes Nur-Benachrichtigungen-Budget aktualisieren, um einen Umfang (Filter) auf ein von Ihnen angegebenes Google Cloud -Projekt festzulegen und den Zeitraum des Budgets von einem Monatsbudget auf ein Quartalsbudget umzustellen.
Um diese Methode aufzurufen, benötigen Sie den budget-id des Budgets, das Sie aktualisieren möchten. Sie können die Budget-ID aus der Ausgabe createBudget erhalten, wenn Sie Ihr Budget erstellen, oder aus der Ausgabe listBudgets, wenn Sie alle Ihre Budgets auflisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
projects/budget-scope-project-id: Das Google Cloud -Projekt, das Sie als Budgetumfang (budgetFilter) festlegen möchten.- billing-account-id: Die ID des Cloud-Rechnungskonto, auf das sich das Budget bezieht.
- budget-id: Die ID des Budgets, das Sie aktualisieren möchten.
- api-user-project-id: Das Google Cloud -Projekt, in dem die Cloud Billing Budget API aktiviert ist.
HTTP-Methode und URL:
PATCH https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id
JSON-Text anfordern:
{
"budget": {
"displayName": "My fancy budget",
"budgetFilter": {
"projects": [
"projects/budget-scope-project-id"
],
"calendar_period": "QUARTER"
},
"amount": {
"specifiedAmount": {
"units": 500
}
},
"thresholdRules": {
"thresholdPercent": 0.8,
"spendBasis": "CURRENT_SPEND"
}
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
"displayName": "My fancy budget",
"budgetFilter": {
"projects": [
"projects/123456789"
],
"creditTypesTreatment": "INCLUDE_ALL_CREDITS",
"calendar_period": "QUARTER"
},
"amount": {
"specifiedAmount": {
"units": 500
}
},
"thresholdRules": {
"thresholdPercent": 0.8,
"spendBasis": "CURRENT_SPEND"
},
"allUpdatesRule": {},
"etag": "f7928d8010160668"
}
Budget löschen
Verwenden Sie diese API-Methode, um ein vorhandenes Cloud Billing-Budget zu löschen.
REST
Um diese Methode aufzurufen, benötigen Sie den budget-id des Budgets, das Sie aktualisieren möchten. Sie können die Budget-ID aus der Ausgabe createBudget erhalten, wenn Sie Ihr Budget erstellen, oder aus der Ausgabe listBudgets, wenn Sie alle Ihre Budgets auflisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- billing-account-id: Die ID des Cloud-Rechnungskonto, auf das sich das Budget bezieht.
- budget-id: Die ID des Budgets, das Sie löschen möchten.
- project-id: Das Google Cloud -Projekt, in dem die Cloud Billing Budget API aktiviert ist.
HTTP-Methode und URL:
DELETE https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{}