Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Beispielreferenzarchitektur
Abbildung 1: Ein Beispiel für die Verwendung von Budgetbenachrichtigungen zur Automatisierung von Kostenkontrollantworten mit Pub/Sub für programmatische Benachrichtigungen und Cloud Run-Funktionen zur Automatisierung einer Antwort.
In diesem Dokument wird beschrieben, wie Sie programmatische Budgetbenachrichtigungen empfangen, indem Sie Ihr Pub/Sub-Thema mit Cloud Run Functions-Triggern abonnieren. Ohne ein Abo werden veröffentlichte Nachrichten durch Pub/Sub gelöscht und Sie können diese später nicht mehr abrufen. In diesem Dokument erfahren Sie, wie Sie die folgenden Aufgaben ausführen:
Cloud Run-Funktion erstellen, die auf Benachrichtigungen wartet
Cloud Run-Funktionsereignisse ansehen
Cloud Run-Funktion testen
Hinweise
Bevor Sie beginnen, müssen Sie die folgenden Aufgaben erledigen:
Wählen Sie Funktion mit einem Inline-Editor erstellen aus.
Geben Sie einen Dienstnamen ein, der für Ihre Budgetbenachrichtigung aussagekräftig ist.
Wählen Sie die Region aus, in der Ihre Cloud Run-Funktionen ausgeführt werden sollen. Sie können diese Einstellung nach der Bereitstellung Ihrer Funktion nicht mehr bearbeiten.
Klicken Sie auf Trigger hinzufügen und wählen Sie Cloud Pub/Sub aus.
Aktivieren Sie alle erforderlichen APIs, wenn Sie dazu aufgefordert werden.
Führen Sie im Bereich Eventarc-Trigger die folgenden Schritte aus:
Geben Sie einen Triggernamen ein.
Legen Sie für Triggertyp die Option Google-Quellen fest.
Legen Sie Ereignisanbieter auf Cloud Pub/Sub fest.
Wählen Sie das Cloud Pub/Sub-Thema aus, das Sie für das Budget konfiguriert haben.
Wählen Sie eine Region aus.
Klicken Sie auf Trigger speichern.
Bearbeiten Sie die Einstellungen für Identity-Aware Proxy, Abrechnung, Dienstskalierung, Eingang und Container, Volume, Netzwerk, Sicherheit nach Bedarf und klicken Sie dann auf Erstellen.
Schreiben Sie Code mit dem Inline-Editor oder laden Sie eine Datei hoch, in der festgelegt wird, wie Ihre Funktion Benachrichtigungen verarbeiten soll.
Weitere Informationen zu den Benachrichtigungen, die der Code erhalten wird, finden Sie unter Benachrichtigungsformat.
Legen Sie den Funktionseinstiegspunkt auf die richtige auszuführende Funktion fest:
Klicken Sie auf DEPLOY (Bereitstellen).
Cloud Run-Funktionsereignisse ansehen
Klicken Sie nach der Bereitstellung der Cloud Run-Funktion auf LOGS, um die Logs der Funktionsaufrufe aufzurufen.
Cloud Run-Funktion testen
Benachrichtigungen werden an Pub/Sub gesendet und Abonnenten erhalten die Nachrichten. Wenn Sie eine Beispielbenachrichtigung testen möchten, um zu prüfen, ob sich Ihre Funktion wie erwartet verhält, veröffentlichen Sie eine Nachricht in Pub/Sub. Verwenden Sie dazu dieses Objekt als Nachrichtentext:
Sie können auch Nachrichtenattribute wie die billing-konto-ID hinzufügen. Weitere Informationen finden Sie unter Benachrichtigungsformat.
Nächste Schritte
Weitere Informationen zur Verwendung programmatischer Benachrichtigungen finden Sie in den folgenden Beispielen für programmatische Antworten zur Kostenkontrolle:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["\u003cp\u003eThis guide details how to use Cloud Run functions to listen for and respond to programmatic budget notifications sent via Pub/Sub.\u003c/p\u003e\n"],["\u003cp\u003eTo begin, you need to create a budget and configure programmatic notifications to ensure the Pub/Sub topic is correctly set up.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a Cloud Run function by selecting "Cloud Pub/Sub" as the trigger type and choosing the budget-configured topic.\u003c/p\u003e\n"],["\u003cp\u003eAfter deploying your Cloud Run function, you can check the function's logs for invocations and test it by publishing a sample message to the Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eCloud Run functions let you create functions that respond to cloud events without needing to manage a server or runtime environment.\u003c/p\u003e\n"]]],[],null,["# Listen to your Pub/Sub notifications\n\n\u003cbr /\u003e\n\nExample reference architecture\n**Figure 1**: An example of using budget alerts to automate cost control responses using Pub/Sub for programmatic notifications and Cloud Run functions to automate a response.\n\nThis document explains how to listen to your programmatic budget\nnotifications by subscribing to your Pub/Sub topic with\n[Cloud Run function](/functions/docs/concepts/events-triggers)\ntriggers. Without a subscriber, Pub/Sub drops published messages\nand you can't retrieve them later. In this document, you'll learn how to\ncomplete the following tasks:\n\n1. Create a Cloud Run function that listens to notifications.\n2. View Cloud Run function events.\n3. Test a Cloud Run function.\n\n| **Note:** Although there are many ways you can [subscribe to your topic](/pubsub/docs/subscriber), the examples on this page use [Cloud Run functions](/functions/docs). Cloud Run functions lets you create functions that respond to cloud events without needing to manage a server or runtime environment.\n\nBefore you begin\n----------------\n\nBefore you begin, you must complete the following tasks:\n\n1. [Create a budget](/billing/docs/how-to/budgets)\n2. [Set up programmatic notifications](/billing/docs/how-to/budgets-programmatic-notifications)\n\nCreate a Cloud Run function\n---------------------------\n\nTo create a Cloud Run function, complete the following steps:\n\n1. In the Google Cloud console, go to the **Cloud Run functions** page.\n\n [Go to Cloud Run functions](https://console.cloud.google.com/functions)\n2. Click **CREATE SERVICE**.\n\n3. Select **Use an inline editor to create a function**.\n\n4. Enter a **Service name** that's meaningful to\n your budget notification.\n\n5. Select the [region](/functions/docs/locations)\n where your Cloud Run functions will run. You can't edit this setting\n after you deploy your function.\n\n6. Click **Add trigger** and select **Cloud Pub/Sub**.\n\n7. If prompted, enable any required APIs.\n\n8. In the **Eventarc trigger** panel, complete the following steps:\n\n 1. Enter a **Trigger name**.\n 2. Set **Trigger type** to **Google sources**.\n 3. Set **Event provider** to **Cloud Pub/Sub**.\n 4. Select the **Cloud Pub/Sub topic** that you configured on your budget.\n 5. Select a **Region**.\n 6. Click **Save trigger**.\n9. Edit the **Identity-Aware Proxy** , **Billing** , **Service scaling** ,\n **Ingress** , and **Container(s), Volume, Networking, Security** settings\n as needed, then click **Create**.\n\n10. Write code using the inline editor or upload a file that tells your function\n how to handle notifications.\n\n See the following examples for code samples:\n - [Send notifications to Slack](/billing/docs/how-to/send-notifications-to-slack)\n - [Control resource usage with notifications](/billing/docs/how-to/control-usage)\n - [Disable billing usage with notifications](/billing/docs/how-to/disable-billing-with-notifications)\n\n For details about the notifications your code will receive, see\n [Notification format](/billing/docs/how-to/budgets-programmatic-notifications#notification-format).\n11. Set **Function entry point** to the correct function to execute:\n\n12. Click **DEPLOY**.\n\nView Cloud Run function events\n------------------------------\n\nAfter you deploy the Cloud Run function, click **LOGS** to view\nthe logs from your function invocations.\n\nTest a Cloud Run function\n-------------------------\n\nAs notifications are sent to Pub/Sub, subscribers receive the\nmessages. To test a sample notification and ensure that your function is working\nas expected,\n[publish a message in Pub/Sub](/pubsub/docs/publisher)\nwith the following object as the message body: \n\n {\n \"budgetDisplayName\": \"name-of-budget\",\n \"alertThresholdExceeded\": 1.0,\n \"costAmount\": 100.01,\n \"costIntervalStart\": \"2019-01-01T00:00:00Z\",\n \"budgetAmount\": 100.00,\n \"budgetAmountType\": \"SPECIFIED_AMOUNT\",\n \"currencyCode\": \"USD\"\n }\n\nYou can also add message attributes such as the billing account ID. For more\ninformation, see\n[Notification format](/billing/docs/how-to/budgets-programmatic-notifications#notification-format).\n\nWhat's next\n-----------\n\nTo learn more about how you can use programmatic notifications, review the\nfollowing examples of programmatic cost control responses:\n\n- [Send notifications to Slack](/billing/docs/how-to/send-notifications-to-slack)\n- [Control resource usage with notifications](/billing/docs/how-to/control-usage)\n- [Disable billing usage with notifications](/billing/docs/how-to/disable-billing-with-notifications)"]]
