你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.Consumption 预算

• 最新
• 2021-10-01
• 2021-05-01
• 2019-11-01
• 2019-10-01
• 2019-06-01
• 2019-05-01
• 2019-05-01-preview
• 2019-04-01-preview
• 2019-01-01
• 2018-10-01
• 2018-08-31
• 2018-06-30
• 2018-03-31
• 2018-01-31
• 2017-12-30-preview

Bicep 资源定义

预算资源类型是 扩展资源，这意味着你可以将其应用于其他资源。

scope使用此资源上的 属性可设置此资源的范围。 请参阅 在 Bicep 中设置扩展资源的范围。

预算资源的有效部署范围包括：

• 资源组 - 请参阅 资源组部署命令
• 订阅 - 请参阅 订阅部署命令

有关每个 API 版本中更改的属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Consumption/budgets 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Consumption/budgets@2021-10-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'
        ]
      }
      tags: {
        name: 'string'
        operator: 'In'
        values: [
          'string'
        ]
      }
    }
    notifications: {}
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

属性值

budgets

名称	说明	值
name	资源名称	字符串 (必需) 字符限制：1-63 有效字符： 字母数字、连字符和下划线。
scope	在与部署范围不同的范围创建扩展资源时使用 。	目标资源 对于 Bicep，请将此属性设置为资源的符号名称以应用 扩展资源。
eTag	资源的 eTag。 若要处理并发更新方案，此字段将用于确定用户是否要更新最新版本。	string
properties	预算的属性。	BudgetProperties

BudgetProperties

名称	说明	值
量	与预算一起跟踪的总成本	int (必需)
category	预算的类别，无论预算是跟踪成本还是使用情况。	“成本” (必需)
filter	可用于按用户指定的维度和/或标记筛选预算。	BudgetFilter
通知	与预算关联的通知字典。 预算最多可以有五个通知。	object
timeGrain	预算涵盖的时间。 将根据时间粒度重置对金额的跟踪。 BillingMonth、BillingQuarter 和 BillingAnnual 仅 WD 客户支持	“每年” “BillingAnnual” “BillingMonth” “BillingQuarter” “Monthly” 需要“季度” ()
timePeriod	具有预算的开始日期和结束日期。 开始日期必须是当月的第一个日期，并且应小于结束日期。 预算开始日期必须是 2017 年 6 月 1 日或之后。 将来的开始日期不应超过 12 个月。 应在时间段内选择过去的开始日期。 结束日期没有限制。	需要 BudgetTimePeriod ()

BudgetFilter

名称	说明	值
和	逻辑“AND”表达式。 必须至少有 2 个项目。	BudgetFilterProperties[]
dimensions	具有维度的比较表达式	BudgetComparisonExpression
标记	具有标记的比较表达式	object

BudgetFilterProperties

名称	说明	值
dimensions	具有维度的比较表达式	BudgetComparisonExpression
标记	具有标记的比较表达式	object

BudgetComparisonExpression

名称	说明	值
name	要用于比较的列的名称。	字符串 (必需)
运算符后的表达式	用于比较的运算符。	“In” (必需)
值	要用于比较的值数组	string[] (必需)

BudgetTimePeriod

名称	说明	值
endDate	预算的结束日期。 如果未提供，则默认为自开始日期起的 10 年。	字符串
startDate	预算的开始日期。	字符串 (必需)

快速入门模板

以下快速入门模板部署此资源类型。

模板	说明
创建预算	此模板演示如何在订阅下创建预算。
使用筛选器创建预算	此模板演示如何在订阅下创建预算。
创建简单预算	此模板演示如何在订阅下创建预算。

ARM 模板资源定义

预算资源类型是 扩展资源，这意味着你可以将其应用于另一个资源。

scope使用此资源上的 属性可设置此资源的作用域。 请参阅 在 ARM 模板中设置扩展资源的范围。

预算资源的有效部署范围包括：

• 资源组 - 请参阅 资源组部署命令
• 订阅 - 请参阅 订阅部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Consumption/budgets 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2021-10-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" ]
      },
      "tags": {
        "name": "string",
        "operator": "In",
        "values": [ "string" ]
      }
    },
    "notifications": {},
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

属性值

budgets

名称	说明	Value
type	资源类型	'Microsoft.Consumption/budgets'
apiVersion	资源 API 版本	'2021-10-01'
name	资源名称	字符串 (必需) 字符限制：1-63 有效字符： 字母数字、连字符和下划线字符。
scope	在不同于部署范围的范围创建扩展资源时使用 。	目标资源 对于 JSON，请将值设置为要向其应用 扩展资源的资源 的全名。
eTag	资源的 eTag。 为了处理并发更新方案，此字段将用于确定用户是否正在更新最新版本。	string
properties	预算的属性。	BudgetProperties

BudgetProperties

名称	说明	值
量	与预算一起跟踪的总成本	int (必需)
category	预算的类别，无论预算是跟踪成本还是使用情况。	需要“成本” ()
filter	可用于按用户指定的维度和/或标记筛选预算。	BudgetFilter
通知	与预算关联的通知字典。 预算最多可以有五个通知。	object
timeGrain	预算涵盖的时间。 将根据时间粒度重置对金额的跟踪。 仅 WD 客户支持 BillingMonth、BillingQuarter 和 BillingAnnual	“每年” 'BillingAnnual' “BillingMonth” 'BillingQuarter' “Monthly” 需要“季度” ()
timePeriod	具有预算的开始和结束日期。 开始日期必须是当月的第一个日期，并且应小于结束日期。 预算开始日期必须在 2017 年 6 月 1 日或之后。 将来的开始日期不应超过 12 个月。 应在时间段内选择过去的开始日期。 结束日期没有限制。	需要 BudgetTimePeriod ()

BudgetFilter

名称	说明	值
和	逻辑“AND”表达式。 必须至少有 2 个项。	BudgetFilterProperties[]
dimensions	具有维度的比较表达式	BudgetComparisonExpression
标记	具有标记的比较表达式	object

BudgetFilterProperties

名称	说明	值
dimensions	具有维度的比较表达式	BudgetComparisonExpression
标记	具有标记的比较表达式	object

BudgetComparisonExpression

名称	说明	值
name	要用于比较的列的名称。	字符串 (必需)
运算符后的表达式	用于比较的运算符。	“In” (必需)
值	要用于比较的值数组	string[] (必需)

BudgetTimePeriod

名称	说明	值
endDate	预算的结束日期。 如果未提供，则默认为自开始日期起的 10 年。	string
startDate	预算的开始日期。	字符串 (必需)

快速入门模板

以下快速入门模板部署此资源类型。

模板	说明
创建预算	此模板演示如何在订阅下创建预算。
使用筛选器创建预算	此模板演示如何在订阅下创建预算。
创建简单预算	此模板演示如何在订阅下创建预算。

Terraform (AzAPI 提供程序) 资源定义

预算资源类型是 扩展资源，这意味着你可以将其应用于另一个资源。

parent_id使用此资源上的 属性可设置此资源的作用域。

预算资源的有效部署范围包括：

• 资源组
• 订阅

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Consumption/budgets 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2021-10-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"
          ]
        }
        tags = {
          name = "string"
          operator = "In"
          values = [
            "string"
          ]
        }
      }
      notifications = {}
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
    eTag = "string"
  })
}

属性值

budgets

名称	说明	Value
type	资源类型	“Microsoft.Consumption/budgets@2021-10-01”
name	资源名称	字符串 (必需) 字符限制：1-63 有效字符： 字母数字、连字符和下划线。
parent_id	要应用此扩展资源的资源的 ID。	字符串 (必需)
eTag	资源的 eTag。 为了处理并发更新方案，此字段将用于确定用户是否正在更新最新版本。	string
properties	预算的属性。	BudgetProperties

BudgetProperties

名称	说明	值
量	与预算一起跟踪的总成本	int (必需)
category	预算的类别，无论预算是跟踪成本还是使用情况。	需要“成本” ()
filter	可用于按用户指定的维度和/或标记筛选预算。	BudgetFilter
通知	与预算关联的通知字典。 预算最多可以有五个通知。	object
timeGrain	预算涵盖的时间。 将根据时间粒度重置对金额的跟踪。 仅 WD 客户支持 BillingMonth、BillingQuarter 和 BillingAnnual	“每年” “BillingAnnual” “BillingMonth” “BillingQuarter” “Monthly” 需要“季度” ()
timePeriod	具有预算的开始和结束日期。 开始日期必须是当月的第一个日期，并且应小于结束日期。 预算开始日期必须在 2017 年 6 月 1 日或之后。 将来的开始日期不应超过 12 个月。 应在时间段内选择过去的开始日期。 结束日期没有限制。	需要 BudgetTimePeriod ()

BudgetFilter

名称	说明	值
和	逻辑“AND”表达式。 必须至少有 2 个项。	BudgetFilterProperties[]
dimensions	具有维度的比较表达式	BudgetComparisonExpression
标记	具有标记的比较表达式	object

BudgetFilterProperties

名称	说明	值
dimensions	具有维度的比较表达式	BudgetComparisonExpression
标记	具有标记的比较表达式	object

BudgetComparisonExpression

名称	说明	值
name	要用于比较的列的名称。	字符串 (必需)
运算符后的表达式	用于比较的运算符。	“In” (必需)
值	要用于比较的值数组	string[] (必需)

BudgetTimePeriod

名称	说明	值
endDate	预算的结束日期。 如果未提供，则默认为自开始日期起的 10 年。	string
startDate	预算的开始日期。	字符串 (必需)