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

Microsoft.Consumption 预算 2018-08-31

Bicep 资源定义

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

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

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

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

资源格式

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

resource symbolicname 'Microsoft.Consumption/budgets@2018-08-31' = {
  name: 'string'
  scope: resourceSymbolicName
  eTag: 'string'
  properties: {
    amount: int
    category: 'string'
    filters: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
      tags: {}
    }
    notifications: {}
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

属性值

budgets

名称 说明 Value
name 资源名称 字符串 (必需)

字符限制:1-63

有效字符:
字母数字、连字符和下划线。
scope 在不同于部署范围的范围创建扩展资源时使用 。 目标资源

对于 Bicep,请将此属性设置为要应用 扩展资源的符号名称。
eTag 资源的 eTag。 为了处理并发更新方案,此字段将用于确定用户是否正在更新最新版本。 string
properties 预算的属性。 BudgetProperties

BudgetProperties

名称 说明 Value
与预算一起跟踪的总成本 int (必需)
category 预算的类别,无论预算是跟踪成本还是使用情况。 “成本”
“使用情况” (必需)
筛选器 可用于按资源组、资源或计量筛选预算。 筛选器
通知 与预算关联的通知字典。 预算最多可以有五个通知。 object
timeGrain 预算涵盖的时间。 将根据时间粒度重置对金额的跟踪。 “每年”
“Monthly”
需要“季度” ()
timePeriod 具有预算的开始和结束日期。 开始日期必须是当月的第一个日期,并且应小于结束日期。 预算开始日期必须在 2017 年 6 月 1 日或之后。 将来的开始日期不应超过三个月。 应在时间段内选择过去的开始日期。 结束日期没有限制。 需要 BudgetTimePeriod ()

筛选器

名称 说明 Value
计量筛选器列表 (GUID) ,对于使用类别的预算是必需的。 string[]
resourceGroups 资源组上的筛选器列表,仅在订阅级别允许。 string[]
resources 资源的筛选器列表。 string[]
标记 标记上的筛选器字典。 object

BudgetTimePeriod

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

快速入门模板

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

模板 说明
创建预算

部署到 Azure
此模板演示如何在订阅下创建预算。
使用筛选器创建预算

部署到 Azure
此模板演示如何在订阅下创建预算。
创建简单预算

部署到 Azure
此模板演示如何在订阅下创建预算。

ARM 模板资源定义

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

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

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

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

资源格式

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

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2018-08-31",
  "name": "string",
  "scope": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filters": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ],
      "tags": {}
    },
    "notifications": {},
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

属性值

budgets

名称 说明 Value
type 资源类型 'Microsoft.Consumption/budgets'
apiVersion 资源 API 版本 '2018-08-31'
name 资源名称 字符串 (必需)

字符限制:1-63

有效字符:
字母数字、连字符和下划线。
scope 在不同于部署范围的范围创建扩展资源时使用 。 目标资源

对于 JSON,请将值设置为要向其应用 扩展资源的资源 的全名。
eTag 资源的 eTag。 为了处理并发更新方案,此字段将用于确定用户是否正在更新最新版本。 string
properties 预算的属性。 BudgetProperties

BudgetProperties

名称 说明 Value
与预算一起跟踪的总成本 int (必需)
category 预算的类别,无论预算是跟踪成本还是使用情况。 “成本”
“使用情况” (必需)
筛选器 可用于按资源组、资源或计量筛选预算。 筛选器
通知 与预算关联的通知字典。 预算最多可以有五个通知。 object
timeGrain 预算涵盖的时间。 将根据时间粒度重置对金额的跟踪。 “每年”
“Monthly”
需要“季度” ()
timePeriod 具有预算的开始和结束日期。 开始日期必须是当月的第一个日期,并且应小于结束日期。 预算开始日期必须在 2017 年 6 月 1 日或之后。 将来的开始日期不应超过三个月。 应在时间段内选择过去的开始日期。 结束日期没有限制。 需要 BudgetTimePeriod ()

筛选器

名称 说明 Value
计量筛选器列表 (GUID) ,对于使用类别的预算是必需的。 string[]
resourceGroups 资源组上的筛选器列表,仅在订阅级别允许。 string[]
resources 资源筛选器列表。 string[]
标记 标记上的筛选器字典。 object

BudgetTimePeriod

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

快速入门模板

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

模板 说明
创建预算

部署到 Azure
此模板演示如何在订阅下创建预算。
使用筛选器创建预算

部署到 Azure
此模板演示如何在订阅下创建预算。
创建简单预算

部署到 Azure
此模板演示如何在订阅下创建预算。

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

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

parent_id使用此资源上的 属性可设置此资源的范围。

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

  • 订阅
  • 资源组

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

资源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2018-08-31"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "string"
      filters = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
        tags = {}
      }
      notifications = {}
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
    eTag = "string"
  })
}

属性值

budgets

名称 说明 Value
type 资源类型 “Microsoft.Consumption/budgets@2018-08-31”
name 资源名称 字符串 (必需)

字符限制:1-63

有效字符:
字母数字、连字符和下划线字符。
parent_id 要向其应用此扩展资源的资源的 ID。 字符串 (必需)
eTag 资源的 eTag。 若要处理并发更新方案,此字段将用于确定用户是否要更新最新版本。 string
properties 预算的属性。 BudgetProperties

BudgetProperties

名称 说明 Value
与预算一起跟踪的总成本 int (必需)
category 预算的类别,无论预算是跟踪成本还是使用情况。 “成本”
“使用情况” (必需)
筛选器 可用于按资源组、资源或计量筛选预算。 筛选器
通知 与预算关联的通知字典。 预算最多可以有五个通知。 object
timeGrain 预算涵盖的时间。 将根据时间粒度重置对金额的跟踪。 “每年”
“Monthly”
需要“季度” ()
timePeriod 具有预算的开始日期和结束日期。 开始日期必须是当月的第一个日期,并且应小于结束日期。 预算开始日期必须是 2017 年 6 月 1 日或之后。 将来的开始日期不应超过三个月。 应在时间段内选择过去的开始日期。 结束日期没有限制。 需要 BudgetTimePeriod ()

筛选器

名称 说明 Value
计量筛选器列表 (GUID) ,对于使用类别的预算是必需的。 string[]
resourceGroups 资源组上的筛选器列表,仅在订阅级别允许。 string[]
resources 资源的筛选器列表。 string[]
标记 标记上的筛选器字典。 object

BudgetTimePeriod

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