Microsoft.Consumption budgets 2019-05-01-preview

• Актуальная
• 2021-10-01
• 2021-05-01
• 2019-11-01
• 2019-10-01
• 2019-06-01
• 2019-05-01
• 2019-05-01-preview
• 2019-04-01-preview
• 01.01.2019
• 2018-10-01
• 2018-08-31
• 2018-06-30
• 31.03.2018
• 2018-01-31
• 30.12.2017

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

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

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

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

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

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

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

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

resource symbolicname 'Microsoft.Consumption/budgets@2019-05-01-preview' = {
  name: 'string'
  scope: resourceSymbolicName
  eTag: 'string'
  properties: {
    amount: int
    category: 'string'
    filters: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
      tags: {}
    }
    notifications: {}
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

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

budgets

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

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

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

Фильтры

Имя	Описание	Значение
Метров	Список фильтров по счетчикам (GUID), обязательных для бюджетов категории использования.	string[]
resourceGroups	Список фильтров для групп ресурсов, разрешенных только на уровне подписки.	string[]
ресурсов	Список фильтров для ресурсов.	string[]
tags	Словарь фильтров для тегов.	object

BudgetTimePeriod

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

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

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

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

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

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

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

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

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

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

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

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

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2019-05-01-preview",
  "name": "string",
  "scope": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filters": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ],
      "tags": {}
    },
    "notifications": {},
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

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

budgets

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

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

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

Фильтры

Имя	Описание	Значение
Метров	Список фильтров по счетчикам (GUID), обязательных для бюджетов категории использования.	string[]
resourceGroups	Список фильтров для групп ресурсов, разрешенных только на уровне подписки.	string[]
ресурсов	Список фильтров по ресурсам.	string[]
tags	Словарь фильтров для тегов.	объект

BudgetTimePeriod

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

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

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

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

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

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

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2019-05-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "string"
      filters = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
        tags = {}
      }
      notifications = {}
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
    eTag = "string"
  })
}

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

budgets

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

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

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

Фильтры

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

BudgetTimePeriod

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