Microsoft.Consumption 預算

發行項
07/20/2023

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。若要處理並行更新案例，此欄位將用來判斷使用者是否要更新最新版本。	字串
properties	預算的屬性。	BudgetProperties

BudgetProperties

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

BudgetFilter

名稱	描述	值
及	邏輯「AND」運算式。必須至少有 2 個專案。	BudgetFilterProperties[]
dimensions	具有維度的比較運算式	BudgetComparisonExpression
tags	具有標記的比較運算式	object

BudgetFilterProperties

名稱	描述	值
dimensions	具有維度的比較運算式	BudgetComparisonExpression
tags	具有標記的比較運算式	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

名稱	描述	值
type	資源類型	'Microsoft.Consumption/budgets'
apiVersion	資源 API 版本	'2021-10-01'
NAME	資源名稱	需要字串 () 字元限制：1-63 有效字元：英數字元、連字號和底線。
scope	在與部署範圍不同的範圍內建立擴充資源時，請使用。	目標資源針對 JSON，請將值設定為要套用擴充資源的資源完整名稱。
etag	資源的 eTag。若要處理並行更新案例，此欄位將用來判斷使用者是否要更新最新版本。	字串
properties	預算的屬性。	BudgetProperties

BudgetProperties

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

BudgetFilter

名稱	描述	值
及	邏輯「AND」運算式。必須至少有 2 個專案。	BudgetFilterProperties[]
dimensions	具有維度的比較運算式	BudgetComparisonExpression
tags	具有標記的比較運算式	object

BudgetFilterProperties

名稱	描述	值
dimensions	具有維度的比較運算式	BudgetComparisonExpression
tags	具有標記的比較運算式	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@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

名稱	描述	值
type	資源類型	「Microsoft.Consumption/budgets@2021-10-01」
NAME	資源名稱	字串 (必要) 字元限制：1-63 有效字元：英數字元、連字號和底線。
parent_id	要套用此延伸模組資源的資源識別碼。	字串 (必要)
etag	資源的 eTag。若要處理並行更新案例，此欄位將用來判斷使用者是否要更新最新版本。	字串
properties	預算的屬性。	BudgetProperties

BudgetProperties

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

BudgetFilter

名稱	描述	值
及	邏輯「AND」運算式。必須至少有 2 個專案。	BudgetFilterProperties[]
dimensions	具有維度的比較運算式	BudgetComparisonExpression
tags	具有標記的比較運算式	object

BudgetFilterProperties

名稱	描述	值
dimensions	具有維度的比較運算式	BudgetComparisonExpression
tags	具有標記的比較運算式	object

BudgetComparisonExpression

名稱	描述	值
NAME	要用於比較的資料行名稱。	字串 (必要)
! 運算子之後	要用於比較的運算子。	必要) (「In」
值	要用於比較的值陣列	string[] (必要)

BudgetTimePeriod

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

Microsoft.Consumption 預算

Bicep 資源定義

資源格式

屬性值

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

快速入門範本

ARM 範本資源定義

資源格式

屬性值

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

快速入門範本

Terraform (AzAPI 提供者) 資源定義

資源格式

屬性值

budgets

BudgetProperties

BudgetFilter

BudgetFilterProperties

BudgetComparisonExpression

BudgetTimePeriod

意見反應

意見反應

其他資源