aws_budgets_budget

Provides a budgets budget resource. Budgets use the cost visualisation provided by Cost Explorer to show you the status of your budgets, to provide forecasts of your estimated costs, and to track your AWS usage, including your free tier usage.

Example Usage

resource "aws_budgets_budget" "ec2" {
  name                  = "budget-ec2-monthly"
  budget_type           = "COST"
  limit_amount          = "1200"
  limit_unit            = "USD"
  time_period_end       = "2087-06-15_00:00"
  time_period_start     = "2017-07-01_00:00"
  time_unit             = "MONTHLY"

  cost_filters {
    service = "ec2"
  }
}

Create a budget for $100.

resource "aws_budgets_budget" "cost" {
  ...
  budget_type  = "COST"
  limit_amount = "100"
  limit_unit   = "USD"
}

Create a budget for s3 with a limit of 3 GB of storage.

resource "aws_budgets_budget" "s3" {
  ...
  budget_type  = "USAGE"
  limit_amount = "3"
  limit_unit   = "GB"
}

Argument Reference

For more detailed documentation about each argument, refer to the AWS official documentation.

The following arguments are supported:

account_id - (Optional) The ID of the target account for budget. Will use current user's account_id by default if omitted.
name - (Optional) The name of a budget. Unique within accounts.
name_prefix - (Optional) The prefix of the name of a budget. Unique within accounts.
budget_type - (Required) Whether this budget tracks monetary cost or usage.
cost_filters - (Optional) Map of CostFilters key/value pairs to apply to the budget.
cost_types - (Optional) Object containing CostTypes The types of cost included in a budget, such as tax and subscriptions..
limit_amount - (Required) The amount of cost or usage being measured for a budget.
limit_unit - (Required) The unit of measurement used for the budget forecast, actual spend, or budget threshold, such as dollars or GB. See Spend documentation.
time_period_end - (Optional) The end of the time period covered by the budget. There are no restrictions on the end date. Format: 2017-01-01_12:00.
time_period_start - (Required) The start of the time period covered by the budget. The start date must come before the end date. Format: 2017-01-01_12:00.
time_unit - (Required) The length of time until a budget resets the actual and forecasted spend. Valid values: MONTHLY, QUARTERLY, ANNUALLY.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

id - id of resource.

CostTypes

Valid keys for cost_types parameter.

include_credit - A boolean value whether to include credits in the cost budget. Defaults to true
include_discount - Specifies whether a budget includes discounts. Defaults to true
include_other_subscription - A boolean value whether to include other subscription costs in the cost budget. Defaults to true
include_recurring - A boolean value whether to include recurring costs in the cost budget. Defaults to true
include_refund - A boolean value whether to include refunds in the cost budget. Defaults to true
include_subscription - A boolean value whether to include subscriptions in the cost budget. Defaults to true
include_support - A boolean value whether to include support costs in the cost budget. Defaults to true
include_tax - A boolean value whether to include tax in the cost budget. Defaults to true
include_upfront - A boolean value whether to include upfront costs in the cost budget. Defaults to true
use_amortized - Specifies whether a budget uses the amortized rate. Defaults to false
use_blended - A boolean value whether to use blended costs in the cost budget. Defaults to false

Refer to AWS CostTypes documentation for further detail.

CostFilters

Valid keys for cost_filters parameter vary depending on the budget_type value.

cost
usage

Refer to AWS CostFilter documentation for further detail.

Import

Budgets can be imported using AccountID:BudgetName, e.g.

$ terraform import aws_budgets_budget.myBudget 123456789012:myBudget