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


Бюджеты Microsoft.Consumption 2018-01-31

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

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

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

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

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

resource symbolicname 'Microsoft.Consumption/budgets@2018-01-31' = {
  scope: resourceSymbolicName or scope
  eTag: 'string'
  name: 'string'
  properties: {
    amount: int
    category: 'string'
    filters: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
    }
    notifications: {
      {customized property}: {
        contactEmails: [
          'string'
        ]
        contactGroups: [
          'string'
        ]
        contactRoles: [
          'string'
        ]
        enabled: bool
        operator: 'string'
        threshold: int
      }
    }
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

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

Microsoft.Потребление/бюджеты

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

Бюджетные свойства

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

БюджетPropertiesNotifications

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

BudgetTimePeriod (БюджетTimePeriod)

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

Фильтры

Имя Описание Ценность
Метров Список фильтров по счетчикам, обязательный для бюджетов категории использования. строка[]
resourceGroups Список фильтров для групп ресурсов, разрешен только на уровне подписки. строка[]
ресурсы Список фильтров по ресурсам. строка[]

Уведомление

Имя Описание Ценность
контактыАдреса электронной почты Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. string[] (обязательно)
контактГруппы Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. строка[]
контактРоли Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. строка[]
Включен Уведомление включено или нет. bool (обязательно)
оператор Оператор сравнения. "EqualTo"
«Больше, чем»
'GreaterThanOrEqualTo' (обязательный)
порог Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. int (обязательно)

Примеры использования

Проверенные модули Azure

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

Модуль Описание
бюджет потребления Модуль ресурсов AVM для бюджета потребления

Примеры быстрого запуска Azure

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

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

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

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

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

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

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

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2018-01-31",
  "name": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filters": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ]
    },
    "notifications": {
      "{customized property}": {
        "contactEmails": [ "string" ],
        "contactGroups": [ "string" ],
        "contactRoles": [ "string" ],
        "enabled": "bool",
        "operator": "string",
        "threshold": "int"
      }
    },
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

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

Microsoft.Потребление/бюджеты

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

Бюджетные свойства

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

БюджетPropertiesNotifications

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

BudgetTimePeriod (БюджетTimePeriod)

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

Фильтры

Имя Описание Ценность
Метров Список фильтров по счетчикам, обязательный для бюджетов категории использования. строка[]
resourceGroups Список фильтров для групп ресурсов, разрешен только на уровне подписки. строка[]
ресурсы Список фильтров по ресурсам. строка[]

Уведомление

Имя Описание Ценность
контактыАдреса электронной почты Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. string[] (обязательно)
контактГруппы Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. строка[]
контактРоли Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. строка[]
Включен Уведомление включено или нет. bool (обязательно)
оператор Оператор сравнения. "EqualTo"
«Больше, чем»
'GreaterThanOrEqualTo' (обязательный)
порог Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. int (обязательно)

Примеры использования

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

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

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

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

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

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2018-01-31"
  name = "string"
  parent_id = "string"
  body = {
    eTag = "string"
    properties = {
      amount = int
      category = "string"
      filters = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
      }
      notifications = {
        {customized property} = {
          contactEmails = [
            "string"
          ]
          contactGroups = [
            "string"
          ]
          contactRoles = [
            "string"
          ]
          enabled = bool
          operator = "string"
          threshold = int
        }
      }
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
  }
}

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

Microsoft.Потребление/бюджеты

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

Бюджетные свойства

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

БюджетPropertiesNotifications

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

BudgetTimePeriod (БюджетTimePeriod)

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

Фильтры

Имя Описание Ценность
Метров Список фильтров по счетчикам, обязательный для бюджетов категории использования. строка[]
resourceGroups Список фильтров для групп ресурсов, разрешен только на уровне подписки. строка[]
ресурсы Список фильтров по ресурсам. строка[]

Уведомление

Имя Описание Ценность
контактыАдреса электронной почты Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. string[] (обязательно)
контактГруппы Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. строка[]
контактРоли Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. строка[]
Включен Уведомление включено или нет. bool (обязательно)
оператор Оператор сравнения. "EqualTo"
«Больше, чем»
'GreaterThanOrEqualTo' (обязательный)
порог Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. int (обязательно)

Примеры использования

Примеры Terraform

Простой пример развертывания бюджета потребления.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "budget" {
  type      = "Microsoft.Consumption/budgets@2019-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  body = {
    properties = {
      amount   = 1000
      category = "Cost"
      filter = {
        tags = {
          name     = "foo"
          operator = "In"
          values   = ["bar"]
        }
      }
      notifications = {
        "Actual_EqualTo_90.000000_Percent" = {
          contactEmails = ["[email protected]", "[email protected]"]
          contactGroups = []
          contactRoles  = []
          enabled       = true
          operator      = "EqualTo"
          threshold     = 90
          thresholdType = "Actual"
        }
      }
      timeGrain = "Monthly"
      timePeriod = {
        startDate = "2025-08-01T00:00:00Z"
      }
    }
  }
}