Бюджеты Microsoft.Consumption

Статья
07/20/2023

Определение ресурса Bicep

Тип ресурса бюджетов является ресурсом расширения, что означает, что его можно применить к другому ресурсу.

scope Используйте свойство этого ресурса, чтобы задать область для этого ресурса. См . раздел Установка области для ресурсов расширения в Bicep.

Допустимые области развертывания для ресурса бюджетов:

Группы ресурсов — см. команды развертывания группы ресурсов.
Подписки — см. команды развертывания подписки.

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

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

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

resource symbolicname 'Microsoft.Consumption/budgets@2021-10-01' = {
  name: 'string'
  scope: resourceSymbolicName
  eTag: 'string'
  properties: {
    amount: int
    category: 'Cost'
    filter: {
      and: [
        {
          dimensions: {
            name: 'string'
            operator: 'In'
            values: [
              'string'
            ]
          }
          tags: {
            name: 'string'
            operator: 'In'
            values: [
              'string'
            ]
          }
        }
      ]
      dimensions: {
        name: 'string'
        operator: 'In'
        values: [
          'string'
        ]
      }
      tags: {
        name: 'string'
        operator: 'In'
        values: [
          'string'
        ]
      }
    }
    notifications: {}
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

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

budgets

Имя	Описание	Значение
name	имя ресурса.	строка (обязательно) Ограничение символов: 1–63 Допустимые символы: Буквенно-цифровые символы, дефисы и символы подчеркивания.
область	Используйте при создании ресурса расширения в области, отличной от области развертывания.	Целевой ресурс Для Bicep задайте для этого свойства символьное имя ресурса, чтобы применить ресурс расширения.
eTag	eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию.	строка
properties	Свойства бюджета.	Бюджетные свойства

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

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

Фильтр бюджета

Имя	Описание	Значение
и	Логическое выражение "AND". Должен содержать по крайней мере 2 элемента.	BudgetFilterProperties[]
dimensions	Имеет выражение сравнения для измерения	BudgetComparisonExpression
tags	Имеет выражение сравнения для тега	object

Свойства BudgetFilter

Имя	Описание	Значение
dimensions	Имеет выражение сравнения для измерения	BudgetComparisonExpression
tags	Имеет выражение сравнения для тега	object

BudgetComparisonExpression

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

BudgetTimePeriod

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

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

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

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

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

scope Используйте свойство этого ресурса, чтобы задать область для этого ресурса. См . раздел Установка области для ресурсов расширения в шаблонах ARM.

Допустимые области развертывания для ресурса бюджетов:

Группы ресурсов — см. команды развертывания группы ресурсов.
Подписки — см. команды развертывания подписки.

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

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

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

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2021-10-01",
  "name": "string",
  "scope": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "Cost",
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "string",
            "operator": "In",
            "values": [ "string" ]
          },
          "tags": {
            "name": "string",
            "operator": "In",
            "values": [ "string" ]
          }
        }
      ],
      "dimensions": {
        "name": "string",
        "operator": "In",
        "values": [ "string" ]
      },
      "tags": {
        "name": "string",
        "operator": "In",
        "values": [ "string" ]
      }
    },
    "notifications": {},
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

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

budgets

Имя	Описание	Значение
тип	Тип ресурса	Microsoft.Consumption/budgets
версия_API	Версия API ресурсов	'2021-10-01'
name	имя ресурса.	строка (обязательно) Ограничение символов: 1–63 Допустимые символы: Буквенно-цифровые символы, дефисы и символы подчеркивания.
область	Используйте при создании ресурса расширения в области, отличной от области развертывания.	Целевой ресурс Для JSON задайте значение полного имени ресурса, к который будет применяться ресурс расширения .
eTag	eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию.	строка
properties	Свойства бюджета.	Бюджетные свойства

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

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

Фильтр бюджета

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

Свойства BudgetFilter

Имя	Описание	Значение
dimensions	Имеет выражение сравнения для измерения	BudgetComparisonExpression
tags	Имеет выражение сравнения для тега	object

BudgetComparisonExpression

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

BudgetTimePeriod

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

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

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

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

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

Тип ресурса бюджетов является ресурсом расширения, что означает, что вы можете применить его к другому ресурсу.

parent_id Используйте свойство этого ресурса, чтобы задать область для этого ресурса.

Допустимые области развертывания для ресурса бюджетов:

Группы ресурсов
Подписки

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2021-10-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "Cost"
      filter = {
        and = [
          {
            dimensions = {
              name = "string"
              operator = "In"
              values = [
                "string"
              ]
            }
            tags = {
              name = "string"
              operator = "In"
              values = [
                "string"
              ]
            }
          }
        ]
        dimensions = {
          name = "string"
          operator = "In"
          values = [
            "string"
          ]
        }
        tags = {
          name = "string"
          operator = "In"
          values = [
            "string"
          ]
        }
      }
      notifications = {}
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
    eTag = "string"
  })
}

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

budgets

Имя	Описание	Значение
тип	Тип ресурса	"Microsoft.Consumption/budgets@2021-10-01"
name	имя ресурса.	строка (обязательно) Ограничение символов: 1–63 Допустимые символы: Буквенно-цифровые символы, дефисы и символы подчеркивания.
parent_id	Идентификатор ресурса, к который применяется этот ресурс расширения.	строка (обязательно)
eTag	eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию.	строка
properties	Свойства бюджета.	Бюджетные свойства

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

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

Фильтр бюджета

Имя	Описание	Значение
и	Логическое выражение "AND". Должен содержать по крайней мере 2 элемента.	BudgetFilterProperties[]
dimensions	Имеет выражение сравнения для измерения	BudgetComparisonExpression
tags	Имеет выражение сравнения для тега	object

Свойства BudgetFilter

Имя	Описание	Значение
dimensions	Имеет выражение сравнения для измерения	BudgetComparisonExpression
tags	Имеет выражение сравнения для тега	object

BudgetComparisonExpression

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

BudgetTimePeriod

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

Бюджеты Microsoft.Consumption

Определение ресурса Bicep

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

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

budgets

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

Фильтр бюджета

Свойства BudgetFilter

BudgetComparisonExpression

BudgetTimePeriod

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

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

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

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

budgets

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

Фильтр бюджета

Свойства BudgetFilter

BudgetComparisonExpression

BudgetTimePeriod

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

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

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

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

budgets

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

Фильтр бюджета

Свойства BudgetFilter

BudgetComparisonExpression

BudgetTimePeriod

Обратная связь

Обратная связь

Дополнительные ресурсы