Microsoft.Consumption budgets 2021-05-01

Article
12/28/2022

Bicep resource definition

The budgets resource type is an extension resource, which means you can apply it to another resource.

Use the scope property on this resource to set the scope for this resource. See Set scope on extension resources in Bicep.

Valid deployment scopes for the budgets resource are:

Resource groups - See resource group deployment commands
Subscriptions - See subscription deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Consumption/budgets resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Consumption/budgets@2021-05-01' = {
  name: 'string'
  scope: resourceSymbolicName
  eTag: 'string'
  properties: {
    amount: int
    category: 'Cost'
    filter: {
      and: [
        {
          dimensions: {
            name: 'string'
            operator: 'In'
            values: [
              'string'
            ]
          }
          tags: {
            name: 'string'
            operator: 'In'
            values: [
              'string'
            ]
          }
        }
      ]
      dimensions: {
        name: 'string'
        operator: 'In'
        values: [
          'string'
        ]
      }
      not: {
        dimensions: {
          name: 'string'
          operator: 'In'
          values: [
            'string'
          ]
        }
        tags: {
          name: 'string'
          operator: 'In'
          values: [
            'string'
          ]
        }
      }
      tags: {
        name: 'string'
        operator: 'In'
        values: [
          'string'
        ]
      }
    }
    notifications: {}
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Property values

budgets

Name	Description	Value
name	The resource name	string (required) Character limit: 1-63 Valid characters: Alphanumerics, hyphens, and underscores.
scope	Use when creating an extension resource at a scope that is different than the deployment scope.	Target resource For Bicep, set this property to the symbolic name of the resource to apply the extension resource.
eTag	eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.	string
properties	The properties of the budget.	BudgetProperties

BudgetProperties

Name	Description	Value
amount	The total amount of cost to track with the budget	int (required)
category	The category of the budget, whether the budget tracks cost or usage.	'Cost' (required)
filter	May be used to filter budgets by user-specified dimensions and/or tags.	BudgetFilter
notifications	Dictionary of notifications associated with the budget. Budget can have up to five notifications.	object
timeGrain	The time covered by a budget. Tracking of the amount will be reset based on the time grain. BillingMonth, BillingQuarter, and BillingAnnual are only supported by WD customers	'Annually' 'BillingAnnual' 'BillingMonth' 'BillingQuarter' 'Monthly' 'Quarterly' (required)
timePeriod	Has start and end date of 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. There are no restrictions on the end date.	BudgetTimePeriod (required)

BudgetFilter

Name	Description	Value
and	The logical "AND" expression. Must have at least 2 items.	BudgetFilterProperties[]
dimensions	Has comparison expression for a dimension	BudgetComparisonExpression
not	The logical "NOT" expression.	BudgetFilterProperties
tags	Has comparison expression for a tag	object

BudgetFilterProperties

Name	Description	Value
dimensions	Has comparison expression for a dimension	BudgetComparisonExpression
tags	Has comparison expression for a tag	object

BudgetComparisonExpression

Name	Description	Value
name	The name of the column to use in comparison.	string (required)
operator	The operator to use for comparison.	'In' (required)
values	Array of values to use for comparison	string[] (required)

BudgetTimePeriod

Name	Description	Value
endDate	The end date for the budget. If not provided, we default this to 10 years from the start date.	string
startDate	The start date for the budget.	string (required)

Quickstart templates

The following quickstart templates deploy this resource type.

Template	Description
Create a Budget	This template shows how to create a budget under a subscription.
Create a Budget with Filter	This template shows how to create a budget under a subscription.
Create a Simple Budget	This template shows how to create a budget under a subscription.

ARM template resource definition

The budgets resource type is an extension resource, which means you can apply it to another resource.

Use the scope property on this resource to set the scope for this resource. See Set scope on extension resources in ARM templates.

Valid deployment scopes for the budgets resource are:

Resource groups - See resource group deployment commands
Subscriptions - See subscription deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Consumption/budgets resource, add the following JSON to your template.

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2021-05-01",
  "name": "string",
  "scope": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "Cost",
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "string",
            "operator": "In",
            "values": [ "string" ]
          },
          "tags": {
            "name": "string",
            "operator": "In",
            "values": [ "string" ]
          }
        }
      ],
      "dimensions": {
        "name": "string",
        "operator": "In",
        "values": [ "string" ]
      },
      "not": {
        "dimensions": {
          "name": "string",
          "operator": "In",
          "values": [ "string" ]
        },
        "tags": {
          "name": "string",
          "operator": "In",
          "values": [ "string" ]
        }
      },
      "tags": {
        "name": "string",
        "operator": "In",
        "values": [ "string" ]
      }
    },
    "notifications": {},
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Property values

budgets

Name	Description	Value
type	The resource type	'Microsoft.Consumption/budgets'
apiVersion	The resource api version	'2021-05-01'
name	The resource name	string (required) Character limit: 1-63 Valid characters: Alphanumerics, hyphens, and underscores.
scope	Use when creating an extension resource at a scope that is different than the deployment scope.	Target resource For JSON, set the value to the full name of the resource to apply the extension resource to.
eTag	eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.	string
properties	The properties of the budget.	BudgetProperties

BudgetProperties

Name	Description	Value
amount	The total amount of cost to track with the budget	int (required)
category	The category of the budget, whether the budget tracks cost or usage.	'Cost' (required)
filter	May be used to filter budgets by user-specified dimensions and/or tags.	BudgetFilter
notifications	Dictionary of notifications associated with the budget. Budget can have up to five notifications.	object
timeGrain	The time covered by a budget. Tracking of the amount will be reset based on the time grain. BillingMonth, BillingQuarter, and BillingAnnual are only supported by WD customers	'Annually' 'BillingAnnual' 'BillingMonth' 'BillingQuarter' 'Monthly' 'Quarterly' (required)
timePeriod	Has start and end date of 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. There are no restrictions on the end date.	BudgetTimePeriod (required)

BudgetFilter

Name	Description	Value
and	The logical "AND" expression. Must have at least 2 items.	BudgetFilterProperties[]
dimensions	Has comparison expression for a dimension	BudgetComparisonExpression
not	The logical "NOT" expression.	BudgetFilterProperties
tags	Has comparison expression for a tag	object

BudgetFilterProperties

Name	Description	Value
dimensions	Has comparison expression for a dimension	BudgetComparisonExpression
tags	Has comparison expression for a tag	object

BudgetComparisonExpression

Name	Description	Value
name	The name of the column to use in comparison.	string (required)
operator	The operator to use for comparison.	'In' (required)
values	Array of values to use for comparison	string[] (required)

BudgetTimePeriod

Name	Description	Value
endDate	The end date for the budget. If not provided, we default this to 10 years from the start date.	string
startDate	The start date for the budget.	string (required)

Quickstart templates

The following quickstart templates deploy this resource type.

Template	Description
Create a Budget	This template shows how to create a budget under a subscription.
Create a Budget with Filter	This template shows how to create a budget under a subscription.
Create a Simple Budget	This template shows how to create a budget under a subscription.

Terraform (AzAPI provider) resource definition

The budgets resource type is an extension resource, which means you can apply it to another resource.

Use the parent_id property on this resource to set the scope for this resource.

Valid deployment scopes for the budgets resource are:

Resource groups
Subscriptions

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Consumption/budgets resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2021-05-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "Cost"
      filter = {
        and = [
          {
            dimensions = {
              name = "string"
              operator = "In"
              values = [
                "string"
              ]
            }
            tags = {
              name = "string"
              operator = "In"
              values = [
                "string"
              ]
            }
          }
        ]
        dimensions = {
          name = "string"
          operator = "In"
          values = [
            "string"
          ]
        }
        not = {
          dimensions = {
            name = "string"
            operator = "In"
            values = [
              "string"
            ]
          }
          tags = {
            name = "string"
            operator = "In"
            values = [
              "string"
            ]
          }
        }
        tags = {
          name = "string"
          operator = "In"
          values = [
            "string"
          ]
        }
      }
      notifications = {}
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
    eTag = "string"
  })
}

Property values

budgets

Name	Description	Value
type	The resource type	"Microsoft.Consumption/budgets@2021-05-01"
name	The resource name	string (required) Character limit: 1-63 Valid characters: Alphanumerics, hyphens, and underscores.
parent_id	The ID of the resource to apply this extension resource to.	string (required)
eTag	eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.	string
properties	The properties of the budget.	BudgetProperties

BudgetProperties

Name	Description	Value
amount	The total amount of cost to track with the budget	int (required)
category	The category of the budget, whether the budget tracks cost or usage.	"Cost" (required)
filter	May be used to filter budgets by user-specified dimensions and/or tags.	BudgetFilter
notifications	Dictionary of notifications associated with the budget. Budget can have up to five notifications.	object
timeGrain	The time covered by a budget. Tracking of the amount will be reset based on the time grain. BillingMonth, BillingQuarter, and BillingAnnual are only supported by WD customers	"Annually" "BillingAnnual" "BillingMonth" "BillingQuarter" "Monthly" "Quarterly" (required)
timePeriod	Has start and end date of 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. There are no restrictions on the end date.	BudgetTimePeriod (required)

BudgetFilter

Name	Description	Value
and	The logical "AND" expression. Must have at least 2 items.	BudgetFilterProperties[]
dimensions	Has comparison expression for a dimension	BudgetComparisonExpression
not	The logical "NOT" expression.	BudgetFilterProperties
tags	Has comparison expression for a tag	object

BudgetFilterProperties

Name	Description	Value
dimensions	Has comparison expression for a dimension	BudgetComparisonExpression
tags	Has comparison expression for a tag	object

BudgetComparisonExpression

Name	Description	Value
name	The name of the column to use in comparison.	string (required)
operator	The operator to use for comparison.	"In" (required)
values	Array of values to use for comparison	string[] (required)

BudgetTimePeriod

Name	Description	Value
endDate	The end date for the budget. If not provided, we default this to 10 years from the start date.	string
startDate	The start date for the budget.	string (required)

Share via

Microsoft.Consumption budgets 2021-05-01

Bicep resource definition

Resource format

Property values

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

Quickstart templates

ARM template resource definition

Resource format

Property values

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

Quickstart templates

Terraform (AzAPI provider) resource definition

Resource format

Property values

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

Feedback

Additional resources