Microsoft.Consumption budgets 2019-05-01

Bicep 資源定義

預算資源類型是 延伸模組資源,這表示您可以將它套用至另一個資源。

scope使用此資源上的 屬性來設定此資源的範圍。 請參閱 在 Bicep 中設定擴充功能資源的範圍

預算資源的有效部署範圍如下:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.Consumption/budgets 資源,請將下列 Bicep 新增至您的範本。

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

屬性值

budgets

名稱 描述
NAME 資源名稱 需要字串 ()

字元限制:1-63

有效字元:
英數字元、連字號和底線。
scope 在與部署範圍不同的範圍內建立擴充資源時,請使用 。 目標資源

針對 Bicep,請將此屬性設定為資源的符號名稱,以套用 延伸模組資源
etag 資源的 eTag。 若要處理並行更新案例,此欄位將用來判斷使用者是否要更新最新版本。 字串
properties 預算的屬性。 BudgetProperties

BudgetProperties

名稱 描述
要與預算一起追蹤的總成本金額 需要 int ()
category 預算的類別,不論預算是追蹤成本還是使用量。 'Cost'
必要 ()
filter 可用來依使用者指定的維度和/或標籤來篩選預算。 Filter
通知 與預算相關聯的通知字典。 預算最多可以有五個通知。 object
timeGrain 預算所涵蓋的時間。 追蹤數量將會根據時間細微性重設。 '每年'
'BillingAnnual'
'BillingMonth'
'BillingQuarter'
'Monthly'
「每季」 (必要)
timePeriod 具有預算的開始和結束日期。 開始日期必須是月份的第一個,而且應該小於結束日期。 預算開始日期必須在 2017 年 6 月 1 日或之後。 未來的開始日期不應超過三個月。 過去開始日期應該在 timegrain 期間內選取。 結束日期沒有任何限制。 需要 BudgetTimePeriod ()

篩選

名稱 描述
計量 (GUID) 篩選清單,這是使用量類別預算的必要專案。 string[]
resourceGroups 資源群組的篩選清單,僅限訂用帳戶層級允許。 string[]
resources 資源篩選清單。 string[]
tags 標籤上篩選準則的字典。 object

BudgetTimePeriod

名稱 描述
endDate 預算的結束日期。 如果未提供,我們會從開始日期預設為 10 年。 字串
startDate 預算的開始日期。 需要字串 ()

快速入門範本

下列快速入門範本會部署此資源類型。

[範本] 描述
建立預算

部署至 Azure
此範本示範如何在訂用帳戶下建立預算。
使用篩選建立預算

部署至 Azure
此範本示範如何在訂用帳戶下建立預算。
建立簡單預算

部署至 Azure
此範本示範如何在訂用帳戶下建立預算。

ARM 範本資源定義

預算資源類型是 延伸模組資源,這表示您可以將它套用至另一個資源。

scope使用此資源上的 屬性來設定此資源的範圍。 請參閱 在 ARM 範本中設定擴充功能資源的範圍

預算資源的有效部署範圍如下:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.Consumption/budgets 資源,請將下列 JSON 新增至您的範本。

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

屬性值

budgets

名稱 描述
type 資源類型 'Microsoft.Consumption/budgets'
apiVersion 資源 API 版本 '2019-05-01'
NAME 資源名稱 需要字串 ()

字元限制:1-63

有效字元:
英數字元、連字號和底線。
scope 在與部署範圍不同的範圍內建立擴充資源時,請使用 。 目標資源

針對 JSON,請將值設定為要套用 擴充資源 的資源完整名稱。
etag 資源的 eTag。 若要處理並行更新案例,此欄位將用來判斷使用者是否要更新最新版本。 字串
properties 預算的屬性。 BudgetProperties

BudgetProperties

名稱 描述
要與預算一起追蹤的總成本金額 需要 int ()
category 預算的類別,不論預算是追蹤成本還是使用量。 'Cost'
必要 ()
filter 可用來依使用者指定的維度和/或標籤來篩選預算。 Filter
通知 與預算相關聯的通知字典。 預算最多可以有五個通知。 object
timeGrain 預算所涵蓋的時間。 追蹤數量將會根據時間細微性重設。 '每年'
'BillingAnnual'
'BillingMonth'
'BillingQuarter'
'Monthly'
「每季」 (必要)
timePeriod 具有預算的開始和結束日期。 開始日期必須是月份的第一個,而且應該小於結束日期。 預算開始日期必須在 2017 年 6 月 1 日或之後。 未來的開始日期不應超過三個月。 過去開始日期應該在 timegrain 期間內選取。 結束日期沒有任何限制。 需要 BudgetTimePeriod ()

篩選

名稱 描述
計量 (GUID) 篩選清單,這是使用量類別預算的必要條件。 string[]
resourceGroups 僅限訂用帳戶層級允許的資源群組篩選清單。 string[]
resources 資源上的篩選清單。 string[]
tags 標記篩選的字典。 object

BudgetTimePeriod

名稱 描述
endDate 預算的結束日期。 如果未提供,我們會從開始日期預設為 10 年。 字串
startDate 預算的開始日期。 字串 (必要)

快速入門範本

下列快速入門範本會部署此資源類型。

[範本] 描述
建立預算

部署至 Azure
此範本示範如何在訂用帳戶下建立預算。
使用篩選建立預算

部署至 Azure
此範本示範如何在訂用帳戶下建立預算。
建立簡單預算

部署至 Azure
此範本示範如何在訂用帳戶下建立預算。

Terraform (AzAPI 提供者) 資源定義

預算資源類型是 延伸模組資源,這表示您可以將它套用至另一個資源。

parent_id使用此資源上的 屬性來設定此資源的範圍。

預算資源的有效部署範圍如下:

  • 資源群組
  • 訂用帳戶

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄

資源格式

若要建立 Microsoft.Consumption/budgets 資源,請將下列 Terraform 新增至您的範本。

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

屬性值

budgets

名稱 描述
type 資源類型 「Microsoft.Consumption/budgets@2019-05-01」
NAME 資源名稱 字串 (必要)

字元限制:1-63

有效字元:
英數字元、連字號和底線。
parent_id 要套用此延伸模組資源的資源識別碼。 字串 (必要)
etag 資源的 eTag。 若要處理並行更新案例,此欄位將用來判斷使用者是否要更新最新版本。 字串
properties 預算的屬性。 BudgetProperties

BudgetProperties

名稱 描述
使用預算追蹤的總成本量 int (必要)
category 預算的類別,不論預算是追蹤成本還是使用量。 「成本」
必要) 的「使用量」 (
filter 可用來依使用者指定的維度和/或標籤來篩選預算。 Filter
通知 與預算相關聯的通知字典。 預算最多可以有五個通知。 object
timeGrain 預算所涵蓋的時間。 追蹤量將會根據時間細微性重設。 「每年」
「BillingAnnual」
「BillingMonth」
「BillingQuarter」
「每月」
「每季」 (必要)
timePeriod 預算的開始和結束日期。 開始日期必須是月份的第一個,而且應該小於結束日期。 預算開始日期必須在 2017 年 6 月 1 日或之後。 未來的開始日期不應超過三個月。 過去開始日期應該在 timegrain 期間內選取。 結束日期沒有任何限制。 BudgetTimePeriod (必要)

篩選

名稱 描述
計量 (GUID) 篩選清單,這是使用量類別預算的必要條件。 string[]
resourceGroups 僅限訂用帳戶層級允許的資源群組篩選清單。 string[]
resources 資源上的篩選清單。 string[]
tags 標記篩選的字典。 object

BudgetTimePeriod

名稱 描述
endDate 預算的結束日期。 如果未提供,我們會從開始日期預設為 10 年。 字串
startDate 預算的開始日期。 字串 (必要)