Microsoft.消費予算 2021-10-01

• 最新の を する
• 2024-08-01
• 2023-11-01
• 2023-05-01
• 2023-03-01
• 2022-09-01
• 2021-10-01
• 2021-05-01
• 2019-11-01
• 2019-10-01
• 2019-06-01
• 2019-05-01
• 2019-05-01-プレビュー
• 2019-04-01-プレビュー
• 2019-01-01
• 2018-10-01
• 2018-08-31
• 2018-06-30
• 2018-03-31
• 2018-01-31
• 2017-12-30-プレビュー

Bicep リソース定義

予算リソースの種類は、次をターゲットとする操作でデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Consumption/budgets リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Consumption/budgets@2021-10-01' = {
  scope: resourceSymbolicName or scope
  eTag: 'string'
  name: 'string'
  properties: {
    amount: int
    category: 'string'
    filter: {
      and: [
        {
          dimensions: {
            name: 'string'
            operator: 'string'
            values: [
              'string'
            ]
          }
          tags: {
            name: 'string'
            operator: 'string'
            values: [
              'string'
            ]
          }
        }
      ]
      dimensions: {
        name: 'string'
        operator: 'string'
        values: [
          'string'
        ]
      }
      tags: {
        name: 'string'
        operator: 'string'
        values: [
          'string'
        ]
      }
    }
    notifications: {
      {customized property}: {
        contactEmails: [
          'string'
        ]
        contactGroups: [
          'string'
        ]
        contactRoles: [
          'string'
        ]
        enabled: bool
        locale: 'string'
        operator: 'string'
        threshold: int
        thresholdType: 'string'
      }
    }
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

プロパティ値

Microsoft.Consumption/budgets

名前	形容	価値
eタグ	リソースの eTag。 同時更新シナリオを処理するために、このフィールドを使用して、ユーザーが最新バージョンを更新しているかどうかを判断します。	糸
名前	リソース名	string (必須)
プロパティ	予算のプロパティ。	バジェットプロパティ
スコープ	デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。	このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。

BudgetComparisonExpression(予算比較式)

名前	形容	価値
名前	比較に使用する列の名前。	string (必須)
演算子	比較に使用する演算子。	'In' (必須)
価値観	比較に使用する値の配列	string[] (必須)

バジェットフィルター

名前	形容	価値
そして	論理 "AND" 式。 少なくとも 2 つの項目が必要です。	予算フィルタープロパティ[]
寸法	ディメンションの比較式を持つ	BudgetComparisonExpression(予算比較式)
タグ	タグの比較式を持つ	BudgetComparisonExpression(予算比較式)

BudgetFilterプロパティ

名前	形容	価値
寸法	ディメンションの比較式を持つ	BudgetComparisonExpression(予算比較式)
タグ	タグの比較式を持つ	BudgetComparisonExpression(予算比較式)

バジェットプロパティ

名前	形容	価値
量	予算で追跡するコストの合計	int (必須)
カテゴリ	予算のカテゴリ。予算がコストと使用量のどちらを追跡するか。	'Cost' (必須)
フィルター	ユーザー指定のディメンションやタグで予算をフィルター処理するために使用できます。	バジェットフィルター
通知	予算に関連付けられている通知の辞書。 予算には最大 5 つの通知を含めることができます。	BudgetProperties通知
timeGrain	予算の対象となる時間。 量の追跡は、時間グレインに基づいてリセットされます。 BillingMonth、BillingQuarter、BillingAnnual は WD のお客様のみがサポートしています	「毎年」 「ビリングアニュアル」 「ビリングマンス」 「ビリングクォーター」 「毎月」 '四半期' (必須)
時間期間	予算の開始日と終了日を指定します。 開始日は月の最初の日付にする必要があり、終了日より小さくする必要があります。 予算開始日は、2017 年 6 月 1 日以降である必要があります。 将来の開始日は 12 か月を超えてはなりません。 過去の開始日は、タイムグレイン期間内に選択する必要があります。 終了日に制限はありません。	BudgetTimePeriod (必須)

BudgetProperties通知

名前	形容	価値

予算期間

名前	形容	価値
終了日	予算の終了日。 指定しない場合、既定値は開始日から 10 年です。	糸
開始日	予算の開始日。	string (必須)

通知

名前	形容	価値
contactEメール	しきい値を超えたときに予算通知を送信する電子メール アドレス。 サブスクリプションまたはリソース グループのスコープで少なくとも 1 つの連絡先メールまたは連絡先グループを指定する必要があります。 その他のすべてのスコープには、少なくとも 1 つの連絡先メールが指定されている必要があります。	string[] (必須)
contactGroups (連絡先グループ)	しきい値を超えたときに予算通知を送信するアクション グループ。 完全修飾 Azure リソース ID として指定する必要があります。サブスクリプションまたはリソース グループのスコープでのみサポートされます。	文字列[]
contactRoles(連絡先ロール)	しきい値を超えたときに予算通知を送信する連絡先ロール。	文字列[]
有効	通知が有効かどうか。	bool (必須)
ロケール	受信者が通知を受信する言語	'cs-cz' 'da-dk' 'de-de' 'en-gb' 'en-us' 'es-es' 'fr-fr' 'hu-hu' 'it-it' 'ja-jp' 'ko-kr' 'nb-no' 'nl-nl' 'pl-pl' 'pt-br' 'pt-pt' 'ru-ru' 'sv-se' 'tr-tr' 'zh-cn' 'zh-tw'
演算子	比較演算子。	「等しい」 「グレーター・タン」 'GreaterThanOrEqualTo' (必須)
閾	通知に関連付けられているしきい値。 コストがしきい値を超えたときに通知が送信されます。 これは常にパーセントであり、0 から 1000 の間である必要があります。	int (必須)
thresholdタイプ	しきい値の種類	「実際」 「予測」

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。

モジュール	形容
従量課金予算の	消費予算の AVM リソース モジュール

Azure クイック スタートのサンプル

次 Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル	形容
予算 を作成する	このテンプレートは、サブスクリプションで予算を作成する方法を示しています。
フィルター を使用して予算を作成する	このテンプレートは、サブスクリプションで予算を作成する方法を示しています。
単純な予算 を作成する	このテンプレートは、サブスクリプションで予算を作成する方法を示しています。

ARM テンプレート リソース定義

予算リソースの種類は、次をターゲットとする操作でデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Consumption/budgets リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2021-10-01",
  "name": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "string",
            "operator": "string",
            "values": [ "string" ]
          },
          "tags": {
            "name": "string",
            "operator": "string",
            "values": [ "string" ]
          }
        }
      ],
      "dimensions": {
        "name": "string",
        "operator": "string",
        "values": [ "string" ]
      },
      "tags": {
        "name": "string",
        "operator": "string",
        "values": [ "string" ]
      }
    },
    "notifications": {
      "{customized property}": {
        "contactEmails": [ "string" ],
        "contactGroups": [ "string" ],
        "contactRoles": [ "string" ],
        "enabled": "bool",
        "locale": "string",
        "operator": "string",
        "threshold": "int",
        "thresholdType": "string"
      }
    },
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

プロパティ値

Microsoft.Consumption/budgets

名前	形容	価値
apiVersion (英語)	API のバージョン	'2021-10-01'
eタグ	リソースの eTag。 同時更新シナリオを処理するために、このフィールドを使用して、ユーザーが最新バージョンを更新しているかどうかを判断します。	糸
名前	リソース名	string (必須)
プロパティ	予算のプロパティ。	バジェットプロパティ
種類	リソースの種類	'Microsoft.Consumption/budgets'

BudgetComparisonExpression(予算比較式)

名前	形容	価値
名前	比較に使用する列の名前。	string (必須)
演算子	比較に使用する演算子。	'In' (必須)
価値観	比較に使用する値の配列	string[] (必須)

バジェットフィルター

名前	形容	価値
そして	論理 "AND" 式。 少なくとも 2 つの項目が必要です。	予算フィルタープロパティ[]
寸法	ディメンションの比較式を持つ	BudgetComparisonExpression(予算比較式)
タグ	タグの比較式を持つ	BudgetComparisonExpression(予算比較式)

BudgetFilterプロパティ

名前	形容	価値
寸法	ディメンションの比較式を持つ	BudgetComparisonExpression(予算比較式)
タグ	タグの比較式を持つ	BudgetComparisonExpression(予算比較式)

バジェットプロパティ

名前	形容	価値
量	予算で追跡するコストの合計	int (必須)
カテゴリ	予算のカテゴリ。予算がコストと使用量のどちらを追跡するか。	'Cost' (必須)
フィルター	ユーザー指定のディメンションやタグで予算をフィルター処理するために使用できます。	バジェットフィルター
通知	予算に関連付けられている通知の辞書。 予算には最大 5 つの通知を含めることができます。	BudgetProperties通知
timeGrain	予算の対象となる時間。 量の追跡は、時間グレインに基づいてリセットされます。 BillingMonth、BillingQuarter、BillingAnnual は WD のお客様のみがサポートしています	「毎年」 「ビリングアニュアル」 「ビリングマンス」 「ビリングクォーター」 「毎月」 '四半期' (必須)
時間期間	予算の開始日と終了日を指定します。 開始日は月の最初の日付にする必要があり、終了日より小さくする必要があります。 予算開始日は、2017 年 6 月 1 日以降である必要があります。 将来の開始日は 12 か月を超えてはなりません。 過去の開始日は、タイムグレイン期間内に選択する必要があります。 終了日に制限はありません。	BudgetTimePeriod (必須)

BudgetProperties通知

名前	形容	価値

予算期間

名前	形容	価値
終了日	予算の終了日。 指定しない場合、既定値は開始日から 10 年です。	糸
開始日	予算の開始日。	string (必須)

通知

名前	形容	価値
contactEメール	しきい値を超えたときに予算通知を送信する電子メール アドレス。 サブスクリプションまたはリソース グループのスコープで少なくとも 1 つの連絡先メールまたは連絡先グループを指定する必要があります。 その他のすべてのスコープには、少なくとも 1 つの連絡先メールが指定されている必要があります。	string[] (必須)
contactGroups (連絡先グループ)	しきい値を超えたときに予算通知を送信するアクション グループ。 完全修飾 Azure リソース ID として指定する必要があります。サブスクリプションまたはリソース グループのスコープでのみサポートされます。	文字列[]
contactRoles(連絡先ロール)	しきい値を超えたときに予算通知を送信する連絡先ロール。	文字列[]
有効	通知が有効かどうか。	bool (必須)
ロケール	受信者が通知を受信する言語	'cs-cz' 'da-dk' 'de-de' 'en-gb' 'en-us' 'es-es' 'fr-fr' 'hu-hu' 'it-it' 'ja-jp' 'ko-kr' 'nb-no' 'nl-nl' 'pl-pl' 'pt-br' 'pt-pt' 'ru-ru' 'sv-se' 'tr-tr' 'zh-cn' 'zh-tw'
演算子	比較演算子。	「等しい」 「グレーター・タン」 'GreaterThanOrEqualTo' (必須)
閾	通知に関連付けられているしきい値。 コストがしきい値を超えたときに通知が送信されます。 これは常にパーセントであり、0 から 1000 の間である必要があります。	int (必須)
thresholdタイプ	しきい値の種類	「実際」 「予測」

使用例

Azure クイック スタート テンプレート

このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。

テンプレート	形容
予算 を作成する Azure にデプロイする	このテンプレートは、サブスクリプションで予算を作成する方法を示しています。
フィルター を使用して予算を作成する Azure にデプロイする	このテンプレートは、サブスクリプションで予算を作成する方法を示しています。
単純な予算 を作成する Azure にデプロイする	このテンプレートは、サブスクリプションで予算を作成する方法を示しています。

Terraform (AzAPI プロバイダー) リソース定義

予算リソースの種類は、次をターゲットとする操作でデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Consumption/budgets リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2021-10-01"
  name = "string"
  parent_id = "string"
  body = {
    eTag = "string"
    properties = {
      amount = int
      category = "string"
      filter = {
        and = [
          {
            dimensions = {
              name = "string"
              operator = "string"
              values = [
                "string"
              ]
            }
            tags = {
              name = "string"
              operator = "string"
              values = [
                "string"
              ]
            }
          }
        ]
        dimensions = {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
        tags = {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
      }
      notifications = {
        {customized property} = {
          contactEmails = [
            "string"
          ]
          contactGroups = [
            "string"
          ]
          contactRoles = [
            "string"
          ]
          enabled = bool
          locale = "string"
          operator = "string"
          threshold = int
          thresholdType = "string"
        }
      }
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
  }
}

プロパティ値

Microsoft.Consumption/budgets

名前	形容	価値
eタグ	リソースの eTag。 同時更新シナリオを処理するために、このフィールドを使用して、ユーザーが最新バージョンを更新しているかどうかを判断します。	糸
名前	リソース名	string (必須)
parent_id	この拡張リソースを適用するリソースの ID。	string (必須)
プロパティ	予算のプロパティ。	バジェットプロパティ
種類	リソースの種類	「Microsoft.Consumption/budgets@2021-10-01」

BudgetComparisonExpression(予算比較式)

名前	形容	価値
名前	比較に使用する列の名前。	string (必須)
演算子	比較に使用する演算子。	'In' (必須)
価値観	比較に使用する値の配列	string[] (必須)

バジェットフィルター

名前	形容	価値
そして	論理 "AND" 式。 少なくとも 2 つの項目が必要です。	予算フィルタープロパティ[]
寸法	ディメンションの比較式を持つ	BudgetComparisonExpression(予算比較式)
タグ	タグの比較式を持つ	BudgetComparisonExpression(予算比較式)

BudgetFilterプロパティ

名前	形容	価値
寸法	ディメンションの比較式を持つ	BudgetComparisonExpression(予算比較式)
タグ	タグの比較式を持つ	BudgetComparisonExpression(予算比較式)

バジェットプロパティ

名前	形容	価値
量	予算で追跡するコストの合計	int (必須)
カテゴリ	予算のカテゴリ。予算がコストと使用量のどちらを追跡するか。	'Cost' (必須)
フィルター	ユーザー指定のディメンションやタグで予算をフィルター処理するために使用できます。	バジェットフィルター
通知	予算に関連付けられている通知の辞書。 予算には最大 5 つの通知を含めることができます。	BudgetProperties通知
timeGrain	予算の対象となる時間。 量の追跡は、時間グレインに基づいてリセットされます。 BillingMonth、BillingQuarter、BillingAnnual は WD のお客様のみがサポートしています	「毎年」 「ビリングアニュアル」 「ビリングマンス」 「ビリングクォーター」 「毎月」 '四半期' (必須)
時間期間	予算の開始日と終了日を指定します。 開始日は月の最初の日付にする必要があり、終了日より小さくする必要があります。 予算開始日は、2017 年 6 月 1 日以降である必要があります。 将来の開始日は 12 か月を超えてはなりません。 過去の開始日は、タイムグレイン期間内に選択する必要があります。 終了日に制限はありません。	BudgetTimePeriod (必須)

BudgetProperties通知

名前	形容	価値

予算期間

名前	形容	価値
終了日	予算の終了日。 指定しない場合、既定値は開始日から 10 年です。	糸
開始日	予算の開始日。	string (必須)

通知

名前	形容	価値
contactEメール	しきい値を超えたときに予算通知を送信する電子メール アドレス。 サブスクリプションまたはリソース グループのスコープで少なくとも 1 つの連絡先メールまたは連絡先グループを指定する必要があります。 その他のすべてのスコープには、少なくとも 1 つの連絡先メールが指定されている必要があります。	string[] (必須)
contactGroups (連絡先グループ)	しきい値を超えたときに予算通知を送信するアクション グループ。 完全修飾 Azure リソース ID として指定する必要があります。サブスクリプションまたはリソース グループのスコープでのみサポートされます。	文字列[]
contactRoles(連絡先ロール)	しきい値を超えたときに予算通知を送信する連絡先ロール。	文字列[]
有効	通知が有効かどうか。	bool (必須)
ロケール	受信者が通知を受信する言語	'cs-cz' 'da-dk' 'de-de' 'en-gb' 'en-us' 'es-es' 'fr-fr' 'hu-hu' 'it-it' 'ja-jp' 'ko-kr' 'nb-no' 'nl-nl' 'pl-pl' 'pt-br' 'pt-pt' 'ru-ru' 'sv-se' 'tr-tr' 'zh-cn' 'zh-tw'
演算子	比較演算子。	「等しい」 「グレーター・タン」 'GreaterThanOrEqualTo' (必須)
閾	通知に関連付けられているしきい値。 コストがしきい値を超えたときに通知が送信されます。 これは常にパーセントであり、0 から 1000 の間である必要があります。	int (必須)
thresholdタイプ	しきい値の種類	「実際」 「予測」