create_budget
Destructive
Set up a cloud budget with spending limits, alert thresholds, and scope filters to monitor and control costs.
Instructions
Use this when the user wants to create a new cloud budget with spending limits and alert thresholds. Requires budget name, currency, type, and start period. Ask the user to confirm the budget parameters before executing. Do NOT use this for viewing existing budgets (use list_budgets or get_budget) or creating alerts (use create_alert).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Budget name (required, non-empty). | |
| amount | No | Budget period amount. Required if usePrevSpend is false. | |
| currency | Yes | Currency code (required). Accepted values: USD, ILS, EUR, AUD, CAD, GBP, DKK, NOK, SEK, BRL, SGD, MXN, CHF, MYR, TWD, EGP, ZAR, JPY, IDR, AED, THB, COP. | |
| type | Yes | Budget type (required). Accepted values: fixed, recurring. | |
| timeInterval | No | Recurring budget interval. Required for recurring budgets. Accepted values: day, week, month, quarter, year. | |
| startPeriod | Yes | Budget start date as a UNIX timestamp in milliseconds (required). | |
| endPeriod | No | Fixed budget end date as a UNIX timestamp in milliseconds. Required if type is fixed, must not be set for recurring. | |
| description | No | Budget description. | |
| usePrevSpend | No | Use the last period's spend as the target amount for recurring budgets. Defaults to false. | |
| growthPerPeriod | No | Periodical growth percentage in recurring budgets. Must be >= 0. Defaults to 0. | |
| metric | No | Budget metric. Accepted values: cost, amortized_cost. Defaults to cost. | |
| public | No | Public sharing access level. Accepted values: owner, editor, viewer. | |
| scopes | No | Filters that define the scope of the budget. Exactly one of scope or scopes must be provided. | |
| scope | No | List of allocations that define the budget scope (deprecated). Exactly one of scope or scopes must be provided. | |
| collaborators | No | List of permitted users to view/edit the budget. If provided, must include at least one collaborator with role 'owner'. | |
| alerts | No | List of up to three alert thresholds defined as a percentage of the amount. | |
| recipients | No | List of email addresses to notify when reaching an alert threshold. | |
| recipientsSlackChannels | No | List of Slack channels to notify when reaching an alert threshold. | |
| seasonalAmounts | No | List of seasonal amounts for recurring budgets with different amounts per period. |