aws-budgets
TLDR
Create a monthly cost budget
SYNOPSIS
aws budgets command [options]
DESCRIPTION
aws budgets manages AWS Budgets for cost control and monitoring. Budgets track spending or usage against defined limits and send alerts when thresholds are approached or exceeded.
Create budgets to monitor overall account costs, specific services, linked accounts, or tagged resources. Notifications alert subscribers via email or SNS when spending reaches specified percentages of the budget limit.
Budget actions automate responses to budget alerts, such as applying restrictive IAM policies or stopping EC2 instances when thresholds are exceeded.
Time units include DAILY, MONTHLY, QUARTERLY, and ANNUALLY. If no start date is specified, budgets begin at the start of the chosen period.
PARAMETERS
create-budget
Create a new budget with optional notificationsdescribe-budgets
List all budgets for an accountdescribe-budget
Get details of a specific budgetupdate-budget
Modify an existing budgetdelete-budget
Remove a budgetcreate-budget-action
Create automated actions when thresholds are exceededdescribe-budget-actions-for-budget
List actions associated with a budgetcreate-notification
Add a notification to an existing budget--account-id id
AWS account ID (12 digits)--budget json
Budget specification (inline JSON or file://path)--budget-name name
Name of the budget--notifications-with-subscribers json
Notification thresholds and subscriber emails/SNS topics--new-budget json
Updated budget specification
BUDGET JSON STRUCTURE
"BudgetName": "Monthly-EC2-Budget",
"BudgetLimit": {"Amount": "100", "Unit": "USD"},
"TimeUnit": "MONTHLY",
"BudgetType": "COST"
}
CAVEATS
Budgets have a processing delay of up to 24 hours for cost data. Budget limits are soft limits that trigger alerts but don't automatically stop spending. Free tier includes 2 budgets; additional budgets incur charges. Account ID must be specified explicitly in CLI commands.
HISTORY
AWS Budgets launched in January 2017 as part of AWS Cost Management tools. It evolved from the earlier Billing Alerts feature. Budget actions for automated responses were added in 2020, enabling automatic cost control measures beyond just notifications.
SEE ALSO
aws(1), aws-ce(1), aws-organizations(1)


