budget cap
The budget cap command group operates on the monthlyCapUsd field of an
app's budget config. Currently exposes a single subcommand: raise. Lowering
or removing the cap is done through convox budget set or convox budget clear.
budget cap raise
Raise the monthly cap. Atomic with breaker-clear when the new cap is above current spend.
Requires admin role on the rack. A non-admin caller (
rwrole) receives403 AppBudgetSet: admin role required to set budget cap. Basic-auth (rack-password) callers automatically pass the admin check.
Usage
convox budget cap raise <app> --monthly-cap-usd N
Examples
$ convox budget cap raise myapp --monthly-cap-usd 500
Raising monthly cap for myapp... OK
If the new cap is below current spend, the request is rejected:
$ convox budget cap raise myapp --monthly-cap-usd 100
error: new cap 100.00 USD is below current spend 134.65 USD
Use convox cost --app myapp to confirm current spend before raising.
After an auto-shutdown, cap-raise clears the breaker but does NOT restart
already-shutdown services. Run convox budget reset myapp to restart them.
See Also
- budget: full budget command group
- budget reset: acknowledge cap breach without raising
- Cap raise: operational guide
