Budgets API (deprecated)
Last updated
Last updated
As of v1.107 of Kubecost, this version of the Budget API is now deprecated. This page should not be consulted. Please reference the current Budget API doc for updated information.
The Budget API allows you to create, update, and delete recurring budget rules to control your Kubernetes spending. Weekly and monthly budgets can be established to set limits on cost spend.
POST
http://<your-kubecost-address>/model/budget/recurring/set
Creates a recurring budget rule or updates a recurring budget rule when provided the ID of the existing rule.
Name | Type | Description |
---|---|---|
GET
http://<your-kubecost-address>/model/budget/recurring/list
Lists all existing recurring budget rules
DELETE
https://<your-kubecost-address>/model/budget/recurring/delete
Deletes a budget rule defined by id
Creating and updating recurring budget rules uses POST requests, which will require submitting a JSON object in the body of your request instead of adding parameters directly into the path (such as when deleting a recurring budget rule). See the Examples section below for more information on formatting your requests.
id
parameterThe id
parameter when using the endpoint /setRecurringBudgetRules
is considered optional, but its use will vary depending on whether you want to create or update a budget rule.
When creating a new budget rule, id
should not be used. An ID for the budget rule will then be randomly generated in the response. When updating an existing budget rule, id
needs to be used to identify which budget rule you want to modify, even if you only have one existing rule.
The id
value of your recurring budget is needed to update or delete it. If you don't have the id
value saved, you can retrieve it using /getRecurringBudgetRules
, which will generate all existing budgets and their respective id
values.
The amount
parameter will always be determined using your configured currency type. You can manually change your currency type in Kubecost by selecting Settings, then scrolling to Currency and selecting your desired currency from the dropdown (remember to confirm your choice by selecting Save at the bottom of the page).
Kubecost does not convert spending costs to other currency types; it will only change the symbol displayed in the UI next to costs. For best results, configure your currency to what matches your spend.
Name | Type | Description |
---|---|---|
name*
string
Name of the budget rule
filter
string
The filter (either namespace
or cluster
) for the rule.
interval*
string
The interval that the budget will reset with (either weekly
or monthly
).
intervalDay
int
The day the budget will reset. When interval=weekly
, intervalDay
is the day of the week, with intervalDay=0
for Sunday, intervalDay=1
for Monday, etc. When interval=monthly
, intervalDay
corresponds with the day of the month.
amount
string
The budget limit value. Currency can be configured in Settings > Cloud Cost Settings > Currency dropdown.
id
string
Only should be used when updating a budget rule, ID of the budget rule being modified
id
string
ID of the recurring budget rule to be deleted