Бюджеты 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 | Тип порогового значения | "Фактический" "Прогнозируемый" |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
Шаблон | Описание |
---|---|
создание бюджета развертывание |
В этом шаблоне показано, как создать бюджет в подписке. |
создание бюджета с помощью фильтра развертывание |
В этом шаблоне показано, как создать бюджет в подписке. |
создание простого бюджетного развертывание |
В этом шаблоне показано, как создать бюджет в подписке. |
Определение ресурса 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 | Тип порогового значения | "Фактический" "Прогнозируемый" |