list_budgets
Read-only
Retrieve cloud spending budgets with names, amounts, and utilization. Filter budgets by owner, creation time, or name to 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 |
|---|---|---|---|
| maxResults | No | The maximum number of results to return in a single page. Defaults to 50. | |
| pageToken | No | Page token, returned by a previous call, to request the next page of results. | |
| 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". | |
| name | No | Partial name filter (case-insensitive). Returns only budgets whose name contains this string. | |
| minCreationTime | No | Min value for budget creation time, in milliseconds since the POSIX epoch. Only budgets created after or at this timestamp are returned. | |
| maxCreationTime | No | Max value for budget creation time, in milliseconds since the POSIX epoch. Only budgets created before or at this timestamp are returned. |