list_budgets
Read-only
List cloud budgets with names, amounts, and utilization. Use filters to narrow down and check budget status.
Instructions
Use this when the user wants to see their cloud spending budgets or check budget status. Returns a paginated list of budgets with names, amounts, and utilization. Do NOT use this for cost analysis (use run_query) or spending alerts (use list_alerts).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Partial name filter (case-insensitive). Returns only budgets whose name contains this string. | |
| filter | No | An expression for filtering the results. Syntax: "key:[<value>]". Available keys: owner, lastModified in ms (>lastModified). Multiple filters can be connected using a pipe |. Note that using different keys in the same filter results in "AND," while using the same key multiple times in the same filter results in "OR". | |
| pageToken | No | Page token, returned by a previous call, to request the next page of results. | |
| maxResults | No | The maximum number of results to return in a single page. Defaults to 50. | |
| maxCreationTime | No | Max value for budget creation time, in milliseconds since the POSIX epoch. Only budgets created before or at this timestamp are returned. | |
| minCreationTime | No | Min value for budget creation time, in milliseconds since the POSIX epoch. Only budgets created after or at this timestamp are returned. |