Azure Consumption Budget Resource Group
This page shows how to write Terraform and Azure Resource Manager for Consumption Budget Resource Group and write them securely.
azurerm_consumption_budget_resource_group (Terraform)
The Budget Resource Group in Consumption can be configured in Terraform with the resource name azurerm_consumption_budget_resource_group
. The following sections describe 2 examples of how to use the resource and its parameters.
Example Usage from GitHub
resource "azurerm_consumption_budget_resource_group" "this" {
name = azurecaf_name.this_name.result
resource_group_id = coalesce(
try(var.settings.resource_group.id, null),
try(var.local_combined_resources["resource_groups"][try(var.settings.resource_group.lz_key, var.client_config.landingzone_key)][var.settings.resource_group.key].id, null)
)
resource "azurerm_consumption_budget_resource_group" "this" {
name = azurecaf_name.this_name.result
resource_group_id = coalesce(
try(var.settings.resource_group.id, null),
try(var.local_combined_resources["resource_groups"][try(var.settings.resource_group.lz_key, var.client_config.landingzone_key)][var.settings.resource_group.key].id, null)
)
Parameters
The following arguments are supported:
name
- (Required) The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.resource_group_id
- (Required) The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.amount
- (Required) The total amount of cost to track with the budget.time_grain
- (Required) The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one ofMonthly
,Quarterly
,Annually
,BillingMonth
,BillingQuarter
, orBillingYear
. Defaults toMonthly
.time_period
- (Required) Atime_period
block as defined below.notification
- (Required) One or morenotification
blocks as defined below.filter
- (Optional) Afilter
block as defined below.
A filter
block supports the following:
dimension
- (Optional) One or moredimension
blocks as defined below to filter the budget on.tag
- (Optional) One or moretag
blocks as defined below to filter the budget on.not
- (Optional) Anot
block as defined below to filter the budget on.
A not
block supports the following:
dimension
- (Optional) Onedimension
block as defined below to filter the budget on. Conflicts withtag
.tag
- (Optional) Onetag
block as defined below to filter the budget on. Conflicts withdimension
.
A notification
block supports the following:
operator
- (Required) The comparison operator for the notification. Must be one ofEqualTo
,GreaterThan
, orGreaterThanOrEqualTo
.threshold
- (Required) Threshold value associated with a notification. Notification is sent when the cost exceeded the threshold. It is always percent and has to be between 0 and 1000.threshold_type
- (Optional) The type of threshold for the notification. This determines whether the notification is triggered by forecasted costs or actual costs. The allowed values areActual
andForecasted
. Default isActual
.contact_emails
- (Optional) Specifies a list of email addresses to send the budget notification to when the threshold is exceeded.contact_groups
- (Optional) Specifies a list of Action Group IDs to send the budget notification to when the threshold is exceeded.contact_roles
- (Optional) Specifies a list of contact roles to send the budget notification to when the threshold is exceeded.enabled
- (Optional) Should the notification be enabled?
NOTE: A
notification
block cannot have all ofcontact_emails
,contact_roles
, andcontact_groups
empty. This means that at least one of the three must be specified.
A dimension
block supports the following:
name
- (Required) The name of the column to use for the filter. The allowed values areChargeType
,Frequency
,InvoiceId
,Meter
,MeterCategory
,MeterSubCategory
,PartNumber
,PricingModel
,Product
,ProductOrderId
,ProductOrderName
,PublisherType
,ReservationId
,ReservationName
,ResourceGroupName
,ResourceGuid
,ResourceId
,ResourceLocation
,ResourceType
,ServiceFamily
,ServiceName
,UnitOfMeasure
.operator
- (Optional) The operator to use for comparison. The allowed values areIn
.values
- (Required) Specifies a list of values for the column.
A tag
block supports the following:
name
- (Required) The name of the tag to use for the filter.operator
- (Optional) The operator to use for comparison. The allowed values areIn
.values
- (Required) Specifies a list of values for the tag.
A time_period
block supports the following:
start_date
- (Required) The start date for the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should be selected within the timegrain period. Changing this forces a new Resource Group Consumption Budget to be created.end_date
- (Optional) The end date for the budget. If not set this will be 10 years after the start date.
In addition to the Arguments listed above - the following Attributes are exported:
id
- The ID of the Resource Group Consumption Budget.etag
- The ETag of the Resource Group Consumption Budget
Explanation in Terraform Registry
Manages a Resource Group Consumption Budget.
Microsoft.Consumption/budgets (Azure Resource Manager)
The budgets in Microsoft.Consumption can be configured in Azure Resource Manager with the resource name Microsoft.Consumption/budgets
. The following sections describe how to use the resource and its parameters.
Example Usage from GitHub
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"type": "Microsoft.Consumption/budgets",
"eTag": "\"1d34d012214157f\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
Frequently asked questions
What is Azure Consumption Budget Resource Group?
Azure Consumption Budget Resource Group is a resource for Consumption of Microsoft Azure. Settings can be wrote in Terraform.
Where can I find the example code for the Azure Consumption Budget Resource Group?
For Terraform, the pkhuntia/aztfmod and aztfmod/terraform-azurerm-caf source code examples are useful. See the Terraform Example section for further details.
For Azure Resource Manager, the shawns1/shawns1CI, shawns1/shawns1CI and assing/alertExtension source code examples are useful. See the Azure Resource Manager Example section for further details.