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

Microsoft.Consumption 预算 2019-11-01

项目
07/20/2023

Bicep 资源定义

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

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

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

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

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

资源格式

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

resource symbolicname 'Microsoft.Consumption/budgets@2019-11-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'
    }
  }
}

属性值

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
not	逻辑“NOT”表达式。	BudgetFilterProperties
标记	具有标记的比较表达式	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": "2019-11-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"
    }
  }
}

属性值

budgets

名称	说明	Value
type	资源类型	“Microsoft.Consumption/budgets”
apiVersion	资源 API 版本	'2019-11-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
not	逻辑“NOT”表达式。	BudgetFilterProperties
标记	具有标记的比较表达式	object

BudgetFilterProperties

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

BudgetComparisonExpression

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

BudgetTimePeriod

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

快速入门模板

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

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

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

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

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

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

资源组
订阅

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

资源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2019-11-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"
  })
}

属性值

budgets

名称	说明	Value
type	资源类型	“Microsoft.Consumption/budgets@2019-11-01”
name	资源名称	字符串 (必需) 字符限制：1-63 有效字符：字母数字、连字符和下划线。
parent_id	要向其应用此扩展资源的资源的 ID。	字符串 (必需)
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
not	逻辑“NOT”表达式。	BudgetFilterProperties
标记	具有标记的比较表达式	object

BudgetFilterProperties

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

BudgetComparisonExpression

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

BudgetTimePeriod

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

通过

Microsoft.Consumption 预算 2019-11-01

Bicep 资源定义

资源格式

属性值

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

快速入门模板

ARM 模板资源定义

资源格式

属性值

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

快速入门模板

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

资源格式

属性值

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

反馈

其他资源