Budgetkontrolle abrufen
Ruft ab, ob Budgets geprüft werden und über welchen Zeitraum.
GET/v1/workspaces/{regionId}/budget-control
Rückgabe
200 OK mit dem in der Antwort gezeigten Objekt.
Weitere Details
Gibt die Budgetkontroll-Einstellung des Workspace zurück: off, warn oder block, und den Zeitraum, den Budgets abdecken.
Jedes Mitglied des Käufer-Workspace, unabhängig von seiner Einkaufsrolle.
Antwortfelder
mode"off" | "warn" | "block"off: Budgets werden nicht geprüft. warn: Eine Bestellung oder Anforderung über dem Budget ihrer Kostenstelle läuft mit einer Warnung weiter. block: Sie wird mit 409 over_budget abgelehnt.
period"month" | "quarter" | "year"Der Zeitraum, den ein Budget abdeckt und über den Ausgaben gezählt werden.
Fehler
- 401 Unauthorized - Es wurden keine Zugangsdaten übermittelt, oder der Bearer-Token bzw. der X-Api-Key-Wert fehlt, ist ungültig, abgelaufen oder widerrufen.
- 403 Forbidden - Der Bearer-Token oder API-Schlüssel des Aufrufers gewährt keinen Zugriff auf diesen Workspace (regionId) oder hat nicht die erforderliche Rolle.
curl "$PLEAXY_API_BASE_URL/v1/workspaces/{regionId}/budget-control" \
-H "X-Api-Key: $PLEAXY_API_KEY"{
"mode": "off" | "warn" | "block",
"period": "month" | "quarter" | "year",
"updatedAt": "string",
"updatedBy": "string"
}