Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Определение ресурсов Bicep
Тип ресурса бюджетов можно развернуть с помощью операций, предназначенных для следующих целей:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Consumption/budgets, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.Consumption/budgets@2019-11-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'
]
}
not: {
dimensions: {
name: 'string'
operator: 'string'
values: [
'string'
]
}
tags: {
name: 'string'
operator: 'string'
values: [
'string'
]
}
}
tags: {
name: 'string'
operator: 'string'
values: [
'string'
]
}
}
notifications: {
{customized property}: {
contactEmails: [
'string'
]
contactGroups: [
'string'
]
contactRoles: [
'string'
]
enabled: bool
operator: 'string'
threshold: int
thresholdType: 'string'
}
}
timeGrain: 'string'
timePeriod: {
endDate: 'string'
startDate: 'string'
}
}
}
Значения свойств
Microsoft.Потребление/бюджеты
| Имя | Описание | Ценность |
|---|---|---|
| E-Tag | eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет. | струна |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства бюджета. | Бюджетные свойства |
| размах | Используется при создании ресурса в области, отличной от области развертывания. | Задайте для этого свойства символьное имя ресурса, чтобы применить ресурс расширения. |
ВыражениеBudgetComparison
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя столбца, используемого в сравнении. | строка (обязательно) |
| оператор | Оператор, используемый для сравнения. | "In" (обязательно) |
| Значения | Массив значений, используемых для сравнения | string[] (обязательно) |
БюджетФильтр
| Имя | Описание | Ценность |
|---|---|---|
| и | Логическое выражение "AND". Должно быть не менее 2 элементов. | BudgetFilterProperties[] |
| Размеры | Имеет выражение сравнения для измерения | ВыражениеBudgetComparison |
| не | Логическое выражение NOT. | BudgetFilterProperties |
| Теги | Имеет выражение сравнения для тега | ВыражениеBudgetComparison |
BudgetFilterProperties
| Имя | Описание | Ценность |
|---|---|---|
| Размеры | Имеет выражение сравнения для измерения | ВыражениеBudgetComparison |
| Теги | Имеет выражение сравнения для тега | ВыражениеBudgetComparison |
Бюджетные свойства
| Имя | Описание | Ценность |
|---|---|---|
| количество | Общая сумма затрат для отслеживания с бюджетом | int (обязательно) |
| категория | Категория бюджета, отслеживает ли бюджет затраты или использование. | "Стоимость" (требуется) |
| фильтр | Может использоваться для фильтрации бюджетов по заданным пользователем измерениям и (или) тегам. | БюджетФильтр |
| Уведомления | Словарь уведомлений, связанных с бюджетом. Бюджет может содержать до пяти уведомлений. | БюджетPropertiesNotifications |
| timegrain | Время, покрываемое бюджетом. Отслеживание суммы будет сброшено на основе времени. BillingMonth, BillingQuarter и BillingAnnual поддерживаются только клиентами WD. | "Ежегодно" "BillingAnnual" "BillingMonth" "BillingQuarter" "Ежемесячно" "Квартальный" (обязательный) |
| timePeriod | Имеет дату начала и окончания бюджета. Дата начала должна быть первой из месяца и должна быть меньше даты окончания. Дата начала бюджета должна быть 1 июня 2017 г. или после него. Дата начала будущего не должна превышать двенадцать месяцев. Последнюю дату начала следует выбрать в течение периода времени. Нет ограничений на дату окончания. | BudgetTimePeriod (обязательно) |
БюджетPropertiesNotifications
| Имя | Описание | Ценность |
|---|
BudgetTimePeriod (БюджетTimePeriod)
| Имя | Описание | Ценность |
|---|---|---|
| Дата окончания | Дата окончания бюджета. Если это не указано, по умолчанию это значение 10 лет с даты начала. | струна |
| Дата начала | Дата начала бюджета. | строка (обязательно) |
Уведомление
| Имя | Описание | Ценность |
|---|---|---|
| контактыАдреса электронной почты | Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. Должен иметь по крайней мере одну электронную почту контакта или группу контактов, указанную в области подписки или группы ресурсов. Все остальные области должны иметь по крайней мере один адрес электронной почты контакта. | string[] (обязательно) |
| контактГруппы | Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. Необходимо предоставить в качестве полного идентификатора ресурса Azure. Поддерживается только в области подписки или группы ресурсов. | строка[] |
| контактРоли | Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. | строка[] |
| Включен | Уведомление включено или нет. | bool (обязательно) |
| оператор | Оператор сравнения. | "EqualTo" «Больше, чем» 'GreaterThanOrEqualTo' (обязательный) |
| порог | Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. | int (обязательно) |
| thresholdType | Тип порогового значения | "Фактический" "Прогнозируемый" |
Примеры использования
Проверенные модули Azure
Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.
| Модуль | Описание |
|---|---|
| бюджет потребления | Модуль ресурсов AVM для бюджета потребления |
Примеры быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.
| Bicep-файл | Описание |
|---|---|
| создание бюджета | В этом шаблоне показано, как создать бюджет в подписке. |
| создание бюджета с помощью фильтра | В этом шаблоне показано, как создать бюджет в подписке. |
| создание простого бюджетного | В этом шаблоне показано, как создать бюджет в подписке. |
Определение ресурса шаблона ARM
Тип ресурса бюджетов можно развернуть с помощью операций, предназначенных для следующих целей:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Consumption/budgets, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.Consumption/budgets",
"apiVersion": "2019-11-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" ]
},
"not": {
"dimensions": {
"name": "string",
"operator": "string",
"values": [ "string" ]
},
"tags": {
"name": "string",
"operator": "string",
"values": [ "string" ]
}
},
"tags": {
"name": "string",
"operator": "string",
"values": [ "string" ]
}
},
"notifications": {
"{customized property}": {
"contactEmails": [ "string" ],
"contactGroups": [ "string" ],
"contactRoles": [ "string" ],
"enabled": "bool",
"operator": "string",
"threshold": "int",
"thresholdType": "string"
}
},
"timeGrain": "string",
"timePeriod": {
"endDate": "string",
"startDate": "string"
}
}
}
Значения свойств
Microsoft.Потребление/бюджеты
| Имя | Описание | Ценность |
|---|---|---|
| apiVersion | Версия API | '2019-11-01' |
| E-Tag | eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет. | струна |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства бюджета. | Бюджетные свойства |
| тип | Тип ресурса | "Microsoft.Consumption/budgets" |
ВыражениеBudgetComparison
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя столбца, используемого в сравнении. | строка (обязательно) |
| оператор | Оператор, используемый для сравнения. | "In" (обязательно) |
| Значения | Массив значений, используемых для сравнения | string[] (обязательно) |
БюджетФильтр
| Имя | Описание | Ценность |
|---|---|---|
| и | Логическое выражение "AND". Должно быть не менее 2 элементов. | BudgetFilterProperties[] |
| Размеры | Имеет выражение сравнения для измерения | ВыражениеBudgetComparison |
| не | Логическое выражение NOT. | BudgetFilterProperties |
| Теги | Имеет выражение сравнения для тега | ВыражениеBudgetComparison |
BudgetFilterProperties
| Имя | Описание | Ценность |
|---|---|---|
| Размеры | Имеет выражение сравнения для измерения | ВыражениеBudgetComparison |
| Теги | Имеет выражение сравнения для тега | ВыражениеBudgetComparison |
Бюджетные свойства
| Имя | Описание | Ценность |
|---|---|---|
| количество | Общая сумма затрат для отслеживания с бюджетом | int (обязательно) |
| категория | Категория бюджета, отслеживает ли бюджет затраты или использование. | "Стоимость" (требуется) |
| фильтр | Может использоваться для фильтрации бюджетов по заданным пользователем измерениям и (или) тегам. | БюджетФильтр |
| Уведомления | Словарь уведомлений, связанных с бюджетом. Бюджет может содержать до пяти уведомлений. | БюджетPropertiesNotifications |
| timegrain | Время, покрываемое бюджетом. Отслеживание суммы будет сброшено на основе времени. BillingMonth, BillingQuarter и BillingAnnual поддерживаются только клиентами WD. | "Ежегодно" "BillingAnnual" "BillingMonth" "BillingQuarter" "Ежемесячно" "Квартальный" (обязательный) |
| timePeriod | Имеет дату начала и окончания бюджета. Дата начала должна быть первой из месяца и должна быть меньше даты окончания. Дата начала бюджета должна быть 1 июня 2017 г. или после него. Дата начала будущего не должна превышать двенадцать месяцев. Последнюю дату начала следует выбрать в течение периода времени. Нет ограничений на дату окончания. | BudgetTimePeriod (обязательно) |
БюджетPropertiesNotifications
| Имя | Описание | Ценность |
|---|
BudgetTimePeriod (БюджетTimePeriod)
| Имя | Описание | Ценность |
|---|---|---|
| Дата окончания | Дата окончания бюджета. Если это не указано, по умолчанию это значение 10 лет с даты начала. | струна |
| Дата начала | Дата начала бюджета. | строка (обязательно) |
Уведомление
| Имя | Описание | Ценность |
|---|---|---|
| контактыАдреса электронной почты | Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. Должен иметь по крайней мере одну электронную почту контакта или группу контактов, указанную в области подписки или группы ресурсов. Все остальные области должны иметь по крайней мере один адрес электронной почты контакта. | string[] (обязательно) |
| контактГруппы | Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. Необходимо предоставить в качестве полного идентификатора ресурса Azure. Поддерживается только в области подписки или группы ресурсов. | строка[] |
| контактРоли | Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. | строка[] |
| Включен | Уведомление включено или нет. | bool (обязательно) |
| оператор | Оператор сравнения. | "EqualTo" «Больше, чем» 'GreaterThanOrEqualTo' (обязательный) |
| порог | Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. | int (обязательно) |
| thresholdType | Тип порогового значения | "Фактический" "Прогнозируемый" |
Примеры использования
Шаблоны быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.
| Шаблон | Описание |
|---|---|
|
создание бюджета развертывание |
В этом шаблоне показано, как создать бюджет в подписке. |
|
создание бюджета с помощью фильтра развертывание |
В этом шаблоне показано, как создать бюджет в подписке. |
|
создание простого бюджетного развертывание |
В этом шаблоне показано, как создать бюджет в подписке. |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса бюджетов можно развернуть с помощью операций, предназначенных для следующих целей:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Consumption/budgets, добавьте следующий объект Terraform в шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Consumption/budgets@2019-11-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"
]
}
not = {
dimensions = {
name = "string"
operator = "string"
values = [
"string"
]
}
tags = {
name = "string"
operator = "string"
values = [
"string"
]
}
}
tags = {
name = "string"
operator = "string"
values = [
"string"
]
}
}
notifications = {
{customized property} = {
contactEmails = [
"string"
]
contactGroups = [
"string"
]
contactRoles = [
"string"
]
enabled = bool
operator = "string"
threshold = int
thresholdType = "string"
}
}
timeGrain = "string"
timePeriod = {
endDate = "string"
startDate = "string"
}
}
}
}
Значения свойств
Microsoft.Потребление/бюджеты
| Имя | Описание | Ценность |
|---|---|---|
| E-Tag | eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет. | струна |
| имя | Имя ресурса | строка (обязательно) |
| идентификатор_родителя | Идентификатор ресурса для применения этого ресурса расширения. | строка (обязательно) |
| свойства | Свойства бюджета. | Бюджетные свойства |
| тип | Тип ресурса | "Microsoft.Потребление/budgets@2019-11-01" |
ВыражениеBudgetComparison
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя столбца, используемого в сравнении. | строка (обязательно) |
| оператор | Оператор, используемый для сравнения. | "In" (обязательно) |
| Значения | Массив значений, используемых для сравнения | string[] (обязательно) |
БюджетФильтр
| Имя | Описание | Ценность |
|---|---|---|
| и | Логическое выражение "AND". Должно быть не менее 2 элементов. | BudgetFilterProperties[] |
| Размеры | Имеет выражение сравнения для измерения | ВыражениеBudgetComparison |
| не | Логическое выражение NOT. | BudgetFilterProperties |
| Теги | Имеет выражение сравнения для тега | ВыражениеBudgetComparison |
BudgetFilterProperties
| Имя | Описание | Ценность |
|---|---|---|
| Размеры | Имеет выражение сравнения для измерения | ВыражениеBudgetComparison |
| Теги | Имеет выражение сравнения для тега | ВыражениеBudgetComparison |
Бюджетные свойства
| Имя | Описание | Ценность |
|---|---|---|
| количество | Общая сумма затрат для отслеживания с бюджетом | int (обязательно) |
| категория | Категория бюджета, отслеживает ли бюджет затраты или использование. | "Стоимость" (требуется) |
| фильтр | Может использоваться для фильтрации бюджетов по заданным пользователем измерениям и (или) тегам. | БюджетФильтр |
| Уведомления | Словарь уведомлений, связанных с бюджетом. Бюджет может содержать до пяти уведомлений. | БюджетPropertiesNotifications |
| timegrain | Время, покрываемое бюджетом. Отслеживание суммы будет сброшено на основе времени. BillingMonth, BillingQuarter и BillingAnnual поддерживаются только клиентами WD. | "Ежегодно" "BillingAnnual" "BillingMonth" "BillingQuarter" "Ежемесячно" "Квартальный" (обязательный) |
| timePeriod | Имеет дату начала и окончания бюджета. Дата начала должна быть первой из месяца и должна быть меньше даты окончания. Дата начала бюджета должна быть 1 июня 2017 г. или после него. Дата начала будущего не должна превышать двенадцать месяцев. Последнюю дату начала следует выбрать в течение периода времени. Нет ограничений на дату окончания. | BudgetTimePeriod (обязательно) |
БюджетPropertiesNotifications
| Имя | Описание | Ценность |
|---|
BudgetTimePeriod (БюджетTimePeriod)
| Имя | Описание | Ценность |
|---|---|---|
| Дата окончания | Дата окончания бюджета. Если это не указано, по умолчанию это значение 10 лет с даты начала. | струна |
| Дата начала | Дата начала бюджета. | строка (обязательно) |
Уведомление
| Имя | Описание | Ценность |
|---|---|---|
| контактыАдреса электронной почты | Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения. Должен иметь по крайней мере одну электронную почту контакта или группу контактов, указанную в области подписки или группы ресурсов. Все остальные области должны иметь по крайней мере один адрес электронной почты контакта. | string[] (обязательно) |
| контактГруппы | Группы действий для отправки уведомления о бюджете в момент превышения порогового значения. Необходимо предоставить в качестве полного идентификатора ресурса Azure. Поддерживается только в области подписки или группы ресурсов. | строка[] |
| контактРоли | Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения. | строка[] |
| Включен | Уведомление включено или нет. | bool (обязательно) |
| оператор | Оператор сравнения. | "EqualTo" «Больше, чем» 'GreaterThanOrEqualTo' (обязательный) |
| порог | Пороговое значение, связанное с уведомлением. Уведомление отправляется, когда стоимость превысила пороговое значение. Это всегда процент и должно быть от 0 до 1000. | int (обязательно) |
| thresholdType | Тип порогового значения | "Фактический" "Прогнозируемый" |
Примеры использования
Примеры 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"
}
}
}
}