Tool to manage a single, simple AWS Budget
awsbudget is a small, Python command-line utility for creating simple AWS Budgets.
At the moment, this tool was built to solve a very simple use case - you want to create a single budget in USD, with notifications at three levels:
- You are projected to spend greater than 80% of your budget
- You have spent greater than 70% of your budget
- You've spent 100% of your budget
and you want these notifications to go directly to an email address (vs. to an SNS topic).
Behind the scenes, we create a CloudFormation stack using the template in this repo to manage this budget in the default region tied to your account.
This tool uses boto3 to make requests to AWS. If you're having trouble authenticating to the correct account, note that
boto3 looks for your AWS credentials and profile information in a few different places.
Within your target Python virtual environment, run
pip install awsbudget
git clone this repository, then from the root of the repo, run
pip install .
awsbudget --help to get a full list of options.
You can create a budget by passing all required data as command line options directly:
awsbudget --new --admin_email firstname.lastname@example.org --budget 20
or you can run
and the tool will prompt you for the data interactively:
$ awsbudget --new --profile personal Please enter the email address where you'd like budget notifications sent: email@example.com Sending notifications to firstname.lastname@example.org Enter your budget in USD: 20 Creating a new budget of $20 Created CloudFormation stack to manage budgets: arn:aws:cloudformation:us-east-1:account-id:stack/aws-budgets/stack-id
Note that you can specify that
awsbudget use a specific AWS profile defined in your AWS config file (e.g.
awsbudget --new --profile personal
This can be useful when creating budgets for multiple AWS accounts.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for awsbudget-0.0.7-py3-none-any.whl