Поделиться через


Бюджеты Microsoft.Consumption

Определение ресурсов Bicep

Тип ресурса бюджетов можно развернуть с помощью операций, предназначенных для следующих целей:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Consumption/budgets, добавьте следующий Bicep в шаблон.

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

Значения свойств

BudgetComparisonExpression

Имя Описание Ценность
имя Имя столбца, используемого в сравнении. строка (обязательно)
оператор Оператор, используемый для сравнения. "In" (обязательно)
Значения Массив значений, используемых для сравнения string[] (обязательно)

BudgetFilter

Имя Описание Ценность
и Логическое выражение "AND". Должно быть не менее 2 элементов. BudgetFilterProperties[]
Размеры Имеет выражение сравнения для измерения BudgetComparisonExpression
Теги Имеет выражение сравнения для тега BudgetComparisonExpression

BudgetFilterProperties

Имя Описание Ценность
Размеры Имеет выражение сравнения для измерения BudgetComparisonExpression
Теги Имеет выражение сравнения для тега BudgetComparisonExpression

BudgetProperties

Имя Описание Ценность
количество Общая сумма затрат для отслеживания с бюджетом int (обязательно)
категория Категория бюджета, отслеживает ли бюджет затраты или использование. "Стоимость" (требуется)
фильтр Может использоваться для фильтрации бюджетов по заданным пользователем измерениям и (или) тегам. BudgetFilter
Уведомления Словарь уведомлений, связанных с бюджетом. Бюджет может содержать до пяти уведомлений. BudgetPropertiesNotifications
timeGrain Время, покрываемое бюджетом. Отслеживание суммы будет сброшено на основе времени. BillingMonth, BillingQuarter и BillingAnnual поддерживаются только клиентами WD. "Ежегодно"
"BillingAnnual"
"BillingMonth"
"BillingQuarter"
"Ежемесячно"
"Квартальный" (обязательный)
timePeriod Имеет дату начала и окончания бюджета. Дата начала должна быть первой из месяца и должна быть меньше даты окончания. Дата начала бюджета должна быть 1 июня 2017 г. или после него. Дата начала будущего не должна превышать двенадцать месяцев. Последнюю дату начала следует выбрать в течение периода времени. Нет ограничений на дату окончания. BudgetTimePeriod (обязательно)

БюджетPropertiesNotifications

Имя Описание Ценность

BudgetTimePeriod

Имя Описание Ценность
endDate Дата окончания бюджета. Если это не указано, по умолчанию это значение 10 лет с даты начала. струна
startDate Дата начала бюджета. строка (обязательно)

Microsoft.Consumption/budgets

Имя Описание Ценность
eTag eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет. струна
имя Имя ресурса строка (обязательно)
свойства Свойства бюджета. BudgetProperties
размах Используется при создании ресурса в области, отличной от области развертывания. Задайте для этого свойства символьное имя ресурса, чтобы применить ресурс расширения.

Уведомление

Имя Описание Ценность
contactEmails Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. Должен иметь по крайней мере одну электронную почту контакта или группу контактов, указанную в области подписки или группы ресурсов. Все остальные области должны иметь по крайней мере один адрес электронной почты контакта. string[] (обязательно)
contactGroups Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. Необходимо предоставить в качестве полного идентификатора ресурса Azure. Поддерживается только в области подписки или группы ресурсов. string[]
contactRoles Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. string[]
Включен Уведомление включено или нет. 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'
оператор Оператор сравнения. "EqualTo"
'GreaterThan'
'GreaterThanOrEqualTo' (обязательный)
порог Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. int (обязательно)
thresholdType Тип порогового значения "Фактический"
"Прогнозируемый"

Примеры краткого руководства

Следующие примеры краткого руководства по развертыванию этого типа ресурса.

Bicep-файл Описание
создание бюджета В этом шаблоне показано, как создать бюджет в подписке.
создание бюджета с помощью фильтра В этом шаблоне показано, как создать бюджет в подписке.
создание простого бюджетного В этом шаблоне показано, как создать бюджет в подписке.

Определение ресурса шаблона ARM

Тип ресурса бюджетов можно развернуть с помощью операций, предназначенных для следующих целей:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Consumption/budgets, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2024-08-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"
    }
  }
}

Значения свойств

BudgetComparisonExpression

Имя Описание Ценность
имя Имя столбца, используемого в сравнении. строка (обязательно)
оператор Оператор, используемый для сравнения. "In" (обязательно)
Значения Массив значений, используемых для сравнения string[] (обязательно)

BudgetFilter

Имя Описание Ценность
и Логическое выражение "AND". Должно быть не менее 2 элементов. BudgetFilterProperties[]
Размеры Имеет выражение сравнения для измерения BudgetComparisonExpression
Теги Имеет выражение сравнения для тега BudgetComparisonExpression

BudgetFilterProperties

Имя Описание Ценность
Размеры Имеет выражение сравнения для измерения BudgetComparisonExpression
Теги Имеет выражение сравнения для тега BudgetComparisonExpression

BudgetProperties

Имя Описание Ценность
количество Общая сумма затрат для отслеживания с бюджетом int (обязательно)
категория Категория бюджета, отслеживает ли бюджет затраты или использование. "Стоимость" (требуется)
фильтр Может использоваться для фильтрации бюджетов по заданным пользователем измерениям и (или) тегам. BudgetFilter
Уведомления Словарь уведомлений, связанных с бюджетом. Бюджет может содержать до пяти уведомлений. BudgetPropertiesNotifications
timeGrain Время, покрываемое бюджетом. Отслеживание суммы будет сброшено на основе времени. BillingMonth, BillingQuarter и BillingAnnual поддерживаются только клиентами WD. "Ежегодно"
"BillingAnnual"
"BillingMonth"
"BillingQuarter"
"Ежемесячно"
"Квартальный" (обязательный)
timePeriod Имеет дату начала и окончания бюджета. Дата начала должна быть первой из месяца и должна быть меньше даты окончания. Дата начала бюджета должна быть 1 июня 2017 г. или после него. Дата начала будущего не должна превышать двенадцать месяцев. Последнюю дату начала следует выбрать в течение периода времени. Нет ограничений на дату окончания. BudgetTimePeriod (обязательно)

БюджетPropertiesNotifications

Имя Описание Ценность

BudgetTimePeriod

Имя Описание Ценность
endDate Дата окончания бюджета. Если это не указано, по умолчанию это значение 10 лет с даты начала. струна
startDate Дата начала бюджета. строка (обязательно)

Microsoft.Consumption/budgets

Имя Описание Ценность
apiVersion Версия API '2024-08-01'
eTag eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет. струна
имя Имя ресурса строка (обязательно)
свойства Свойства бюджета. BudgetProperties
тип Тип ресурса "Microsoft.Consumption/budgets"

Уведомление

Имя Описание Ценность
contactEmails Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. Должен иметь по крайней мере одну электронную почту контакта или группу контактов, указанную в области подписки или группы ресурсов. Все остальные области должны иметь по крайней мере один адрес электронной почты контакта. string[] (обязательно)
contactGroups Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. Необходимо предоставить в качестве полного идентификатора ресурса Azure. Поддерживается только в области подписки или группы ресурсов. string[]
contactRoles Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. string[]
Включен Уведомление включено или нет. 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'
оператор Оператор сравнения. "EqualTo"
'GreaterThan'
'GreaterThanOrEqualTo' (обязательный)
порог Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. int (обязательно)
thresholdType Тип порогового значения "Фактический"
"Прогнозируемый"

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
создание бюджета

развертывание в Azure
В этом шаблоне показано, как создать бюджет в подписке.
создание бюджета с помощью фильтра

развертывание в Azure
В этом шаблоне показано, как создать бюджет в подписке.
создание простого бюджетного

развертывание в Azure
В этом шаблоне показано, как создать бюджет в подписке.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса бюджетов можно развернуть с помощью операций, предназначенных для следующих целей:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Consumption/budgets, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2024-08-01"
  name = "string"
  parent_id = "string"
  eTag = "string"
  body = jsonencode({
    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"
      }
    }
  })
}

Значения свойств

BudgetComparisonExpression

Имя Описание Ценность
имя Имя столбца, используемого в сравнении. строка (обязательно)
оператор Оператор, используемый для сравнения. "In" (обязательно)
Значения Массив значений, используемых для сравнения string[] (обязательно)

BudgetFilter

Имя Описание Ценность
и Логическое выражение "AND". Должно быть не менее 2 элементов. BudgetFilterProperties[]
Размеры Имеет выражение сравнения для измерения BudgetComparisonExpression
Теги Имеет выражение сравнения для тега BudgetComparisonExpression

BudgetFilterProperties

Имя Описание Ценность
Размеры Имеет выражение сравнения для измерения BudgetComparisonExpression
Теги Имеет выражение сравнения для тега BudgetComparisonExpression

BudgetProperties

Имя Описание Ценность
количество Общая сумма затрат для отслеживания с бюджетом int (обязательно)
категория Категория бюджета, отслеживает ли бюджет затраты или использование. "Стоимость" (требуется)
фильтр Может использоваться для фильтрации бюджетов по заданным пользователем измерениям и (или) тегам. BudgetFilter
Уведомления Словарь уведомлений, связанных с бюджетом. Бюджет может содержать до пяти уведомлений. BudgetPropertiesNotifications
timeGrain Время, покрываемое бюджетом. Отслеживание суммы будет сброшено на основе времени. BillingMonth, BillingQuarter и BillingAnnual поддерживаются только клиентами WD. "Ежегодно"
"BillingAnnual"
"BillingMonth"
"BillingQuarter"
"Ежемесячно"
"Квартальный" (обязательный)
timePeriod Имеет дату начала и окончания бюджета. Дата начала должна быть первой из месяца и должна быть меньше даты окончания. Дата начала бюджета должна быть 1 июня 2017 г. или после него. Дата начала будущего не должна превышать двенадцать месяцев. Последнюю дату начала следует выбрать в течение периода времени. Нет ограничений на дату окончания. BudgetTimePeriod (обязательно)

БюджетPropertiesNotifications

Имя Описание Ценность

BudgetTimePeriod

Имя Описание Ценность
endDate Дата окончания бюджета. Если это не указано, по умолчанию это значение 10 лет с даты начала. струна
startDate Дата начала бюджета. строка (обязательно)

Microsoft.Consumption/budgets

Имя Описание Ценность
eTag eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет. струна
имя Имя ресурса строка (обязательно)
parent_id Идентификатор ресурса для применения этого ресурса расширения. строка (обязательно)
свойства Свойства бюджета. BudgetProperties
тип Тип ресурса "Microsoft.Consumption/budgets@2024-08-01"

Уведомление

Имя Описание Ценность
contactEmails Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. Должен иметь по крайней мере одну электронную почту контакта или группу контактов, указанную в области подписки или группы ресурсов. Все остальные области должны иметь по крайней мере один адрес электронной почты контакта. string[] (обязательно)
contactGroups Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. Необходимо предоставить в качестве полного идентификатора ресурса Azure. Поддерживается только в области подписки или группы ресурсов. string[]
contactRoles Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. string[]
Включен Уведомление включено или нет. 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'
оператор Оператор сравнения. "EqualTo"
'GreaterThan'
'GreaterThanOrEqualTo' (обязательный)
порог Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. int (обязательно)
thresholdType Тип порогового значения "Фактический"
"Прогнозируемый"