Vercel CLI: Teams können Budgets der Spend Management verwalten und einsehen

Budget im Terminal anzeigen, setzen und entfernen

Laut Vercel lässt sich das Spend-Management-Budget eines Teams jetzt direkt in der Vercel CLI einsehen und verwalten. Der Basisbefehl vercel budgets zeigt die aktuellen Ausgaben und das aktive Budget an. Im Beispiel aus dem Changelog erhält ein Team ohne gesetztes Budget die Meldung, dass seine aktuellen Ausgaben bei 63,33 US-Dollar liegen, dazu einen Hinweis, wie sich ein Budget anlegen lässt.

Ein Budget wird mit vercel budgets set --amount und einem Dollarbetrag erstellt. Das Beispiel setzt ein Budget von 200 US-Dollar; die Ausgabe zeigt anschließend Scope, Betrag, Ausgaben, Prozentwert der Auslastung, Status, Pause-Einstellung und Webhook. In diesem Beispiel hat das Team 32 Prozent seines Budgets verbraucht, der Status ist aktiv und Pause ist aktiviert. Mit vercel budgets remove --yes lässt sich ein Budget löschen; der Befehl bestätigt, dass das Budget von 200 US-Dollar entfernt wurde.

Vercel zufolge handelt es sich um dasselbe On-Demand-Budget, das auch in den Abrechnungseinstellungen des Teams angezeigt wird. CLI und Dashboard greifen also auf dieselbe Einstellung zu.

Ein Budget allein stoppt die Nutzung nicht

Vercel stellt einen Punkt ausdrücklich klar: Ein gesetztes Budget stoppt die Nutzung nicht von selbst. Um ein Limit durchzusetzen, muss das Flag --pause verwendet werden. Damit werden die Produktions-Deployments aller Projekte pausiert, sobald die Ausgaben 100 Prozent erreichen. Im Beispiel gibt der Befehl vercel budgets set --amount 200 --pause aus, dass alle Projekte des Teams bei 100 Prozent (200 US-Dollar) pausiert werden und die Produktions-Deployments dann nicht mehr verfügbar sind.

Teams sollten daher entscheiden, ob sie ein Budget nur als Orientierungswert verwenden oder als harten Stopp für die Produktion.

Verlauf der Budgetwarnungen

Das Update ergänzt außerdem ein Protokoll früherer Budgetwarnungen. vercel budgets alerts zeigt den gesamten Verlauf und lässt sich mit --since, --until, --limit und --json filtern. Die JSON-Option ist nützlich für Skripte und Agenten, die die Ausgabe weiterverarbeiten müssen. Ein einfaches vercel budgets gibt die drei jüngsten Warnungen aus.

Jeder Eintrag in der Beispielausgabe enthält das Datum, den Budget-Scope, den erreichten Schwellenwert, die Ausgaben, den Budgetbetrag und die konfigurierten Aktionen. Die Beispielzeilen zeigen Schwellenwerte von 50, 75 und 100 Prozent, bei den Aktionen steht entweder „notify“ oder „notify and pause“.

Wer die Funktion nutzen kann

Zur Verwaltung von Budgets ist die Rolle Owner oder Billing erforderlich. Laut Vercel steht Spend Management Pro-Teams sowie Enterprise-Teams mit dem Flexible-Commitment-Tarif ohne Zusatzkosten zur Verfügung. Eine vollständige Referenz bietet die CLI-Dokumentation zu vercel budgets, außerdem verweist Vercel auf die allgemeine Dokumentation zu Spend Management.

Für Teams, die Deployments bereits im Terminal oder per Automatisierung steuern, bedeutet die Änderung: Budgetprüfungen, Limits und die Durchsicht von Warnungen erfordern keinen Abstecher mehr in die Abrechnungseinstellungen. Da die Befehle auch von Skripten und Agenten ausgeführt werden können, lassen sich die Ausgaben im Rahmen bestehender Workflows abfragen, innerhalb der von Vercel beschriebenen Rollenbeschränkungen.