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

az monitor alert-processing-rule

  • Предварительный просмотр

Note

Эта ссылка является частью расширения alertsmanagement для Azure CLI (версия 2.45.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az monitor alert-processing-rule. Подробнее о расширениях.

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Управление правилом обработки оповещений с помощью оповещений.

Команды

Имя Описание Тип Состояние
az monitor alert-processing-rule create

Создать правило обработки оповещений.

 Extension Preview
az monitor alert-processing-rule delete

Удаление правила обработки оповещений.

 Extension Preview
az monitor alert-processing-rule list

Список всех правил обработки оповещений в подписке или группе ресурсов.

 Extension Preview
az monitor alert-processing-rule show

Получение правила обработки оповещений.

 Extension Preview
az monitor alert-processing-rule update

Включение, отключение или обновление тегов для правила обработки оповещений.

 Extension Preview

az monitor alert-processing-rule create

Предварительный просмотр

Группа команд "monitor alert-processing-rule" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Создать правило обработки оповещений.

az monitor alert-processing-rule create --name
                                        --resource-group
                                        --rule-type {AddActionGroups, RemoveAllActionGroups}
                                        --scopes
                                        [--action-groups]
                                        [--description]
                                        [--enabled {false, true}]
                                        [--filter-alert-context]
                                        [--filter-alert-rule-description]
                                        [--filter-alert-rule-id]
                                        [--filter-alert-rule-name]
                                        [--filter-monitor-condition]
                                        [--filter-monitor-service]
                                        [--filter-resource-group]
                                        [--filter-resource-type]
                                        [--filter-severity]
                                        [--filter-signal-type]
                                        [--filter-target-resource]
                                        [--schedule-end-datetime]
                                        [--schedule-recurrence]
                                        [--schedule-recurrence-2]
                                        [--schedule-recurrence-2-end-time]
                                        [--schedule-recurrence-2-start-time]
                                        [--schedule-recurrence-2-type {Daily, Monthly, Weekly}]
                                        [--schedule-recurrence-end-time]
                                        [--schedule-recurrence-start-time]
                                        [--schedule-recurrence-type {Daily, Monthly, Weekly}]
                                        [--schedule-start-datetime]
                                        [--schedule-time-zone]
                                        [--tags]

Примеры

Создание или обновление правила, которое добавляет группу действий ко всем оповещениям в подписке

az monitor alert-processing-rule create \
--name 'AddActionGroupToSubscription' \
--rule-type AddActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/ActionGroup1" \
--enabled true \
--resource-group alertscorrelationrg \
--description "Add ActionGroup1 to all alerts in the subscription"

Создание или обновление правила, которое добавляет две группы действий для всех оповещений Sev0 и Sev1 в двух группах ресурсов

az monitor alert-processing-rule create \
--name 'AddActionGroupsBySeverity' \
--rule-type AddActionGroups \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/MyActionGroupId1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2/providers/microsoft.insights/actionGroups/MyActionGroup2" \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-severity Equals Sev0 Sev1 \
--description "Add AGId1 and AGId2 to all Sev0 and Sev1 alerts in these resourceGroups"

Создайте или обновите правило, которое удаляет все группы действий из оповещений на определенной виртуальной машине во время периода обслуживания (1800–2000 по определенной дате, Тихоокеанское стандартное время)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsMaintenanceWindow' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/Microsoft.Compute/virtualMachines/VMName" \
--resource-group alertscorrelationrg \
--schedule-start-datetime '2022-01-02 18:00:00' \
--schedule-end-datetime '2022-01-02 20:00:00' \
--schedule-time-zone 'Pacific Standard Time' \
--description "Removes all ActionGroups from all Alerts on VMName during the maintenance window"

Создание или обновление правила, которое удаляет все группы действий из всех оповещений в подписке, поступающих из определенного правила генерации оповещений

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsSpecificAlertRule' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-alert-rule-id Equals "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/microsoft.insights/activityLogAlerts/RuleName" \
--description "Removes all ActionGroups from all Alerts that fire on above AlertRule"

Создайте или обновите правило, которое удаляет все группы действий из всех оповещений на любой виртуальной машине в двух группах ресурсов во время повторяющегося периода обслуживания (2200-0400 каждый сат и солнце, Индия Стандартное время)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsRecurringMaintenance' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2" \
--resource-group alertscorrelationrg \
--filter-resource-type Equals "microsoft.compute/virtualmachines" \
--schedule-time-zone "India Standard Time" \
--schedule-recurrence-type Weekly \
--schedule-recurrence-start-time "22:00:00" \
--schedule-recurrence-end-time "04:00:00" \
--schedule-recurrence Sunday Saturday \
--description "Remove all ActionGroups from all Virtual machine Alerts during the recurring maintenance"

Создание или обновление правила, которое удаляет все группы действий вне рабочих часов (Mon-Fri 09:00-17:00, восточное стандартное время)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsOutsideBusinessHours' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--schedule-time-zone "Eastern Standard Time" \
--schedule-recurrence-type Daily \
--schedule-recurrence-start-time "17:00:00" \
--schedule-recurrence-end-time "09:00:00" \
--schedule-recurrence-2-type Weekly \
--schedule-recurrence-2 Saturday Sunday \
--description "Remove all ActionGroups outside business hours"

Обязательные параметры

--name -n

Имя правила обработки оповещений.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--rule-type

Укажите тип правила обработки оповещений.

Свойство Значение
Допустимые значения: AddActionGroups, RemoveAllActionGroups
--scopes

Список идентификаторов ресурсов (разделенных пробелами) для области. Правило будет применяться к оповещениям, которые активируются на ресурсах в этой области.

Необязательные параметры

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

--action-groups

Список идентификаторов ресурсов (разделенных пробелами) групп действий для добавления. Для использования этого аргумента требуется, чтобы тип правила — AddActionGroups.

--description

Описание правила обработки оповещений.

--enabled

Укажите, включено или отключено ли данное правило обработки оповещений (по умолчанию включено).

Свойство Значение
Допустимые значения: false, true
--filter-alert-context

Фильтрация оповещений по контексту оповещения (полезные данные).

Формат фильтра— <operator> <space-delimited values> оператор: один из равных, NotEquals, Contains, DoesNotContain Values: список значений, которые соответствуют заданному условию.

Свойство Значение
Группа параметров: Filter Arguments
--filter-alert-rule-description

Фильтрация оповещений по описанию правила генерации оповещений.

Свойство Значение
Группа параметров: Filter Arguments
--filter-alert-rule-id

Фильтрация оповещений по идентификатору оповещения.

Свойство Значение
Группа параметров: Filter Arguments
--filter-alert-rule-name

Фильтрация оповещений по имени правила генерации оповещений.

Свойство Значение
Группа параметров: Filter Arguments
--filter-monitor-condition

Фильтрация оповещений по условию монитора.

Свойство Значение
Группа параметров: Filter Arguments
--filter-monitor-service

Фильтрация оповещений по службе мониторинга.

Свойство Значение
Группа параметров: Filter Arguments
--filter-resource-group

Фильтрация оповещений по группе ресурсов.

Свойство Значение
Группа параметров: Filter Arguments
--filter-resource-type

Фильтрация оповещений по типу ресурса.

Свойство Значение
Группа параметров: Filter Arguments
--filter-severity

Фильтрация оповещений по серьезности Sev0, Sev1, Sev2, Sev3, Sev4.

Свойство Значение
Группа параметров: Filter Arguments
--filter-signal-type

Фильтрация оповещений по типу сигнала.

Свойство Значение
Группа параметров: Filter Arguments
--filter-target-resource

Фильтрация оповещений по ресурсу.

Свойство Значение
Группа параметров: Filter Arguments
--schedule-end-datetime

Дата окончания правила. Формат: "ГГГГ-MM-DD чч:мм:сс".

Свойство Значение
Группа параметров: Schedule Arguments
--schedule-recurrence

Список значений шаблонов повторения.

--schedule-повторение: список значений шаблонов повторения (разделенных пробелами). Для еженедельного типа повторения допустимые значения — воскресенье до субботы. Для ежемесячного типа повторения допустимые значения — от 1 до 31 (дни месяца).

Свойство Значение
Группа параметров: Schedule First Recurrence Arguments
--schedule-recurrence-2

Список значений шаблонов повторения для второго шаблона повторения.

--schedule-повторение-2: список значений шаблонов повторения (разделенных пробелами). Для еженедельного типа повторения допустимые значения — воскресенье до субботы. Для ежемесячного типа повторения допустимые значения — от 1 до 31 (дни месяца).

Свойство Значение
Группа параметров: Schedule Second Recurrence Arguments
--schedule-recurrence-2-end-time

Время окончания каждого повторения. Формат: hh:mm:ss.

Свойство Значение
Группа параметров: Schedule Second Recurrence Arguments
--schedule-recurrence-2-start-time

Время начала для каждого повторения. Формат: hh:mm:ss.

Свойство Значение
Группа параметров: Schedule Second Recurrence Arguments
--schedule-recurrence-2-type

Указывает, когда следует применить правило обработки. По умолчанию — Always.

Свойство Значение
Группа параметров: Schedule Second Recurrence Arguments
Допустимые значения: Daily, Monthly, Weekly
--schedule-recurrence-end-time

Время окончания каждого повторения. Формат: hh:mm:ss.

Свойство Значение
Группа параметров: Schedule First Recurrence Arguments
--schedule-recurrence-start-time

Время начала для каждого повторения. Формат: hh:mm:ss.

Свойство Значение
Группа параметров: Schedule First Recurrence Arguments
--schedule-recurrence-type

Указывает, когда следует применить правило обработки.

Свойство Значение
Группа параметров: Schedule First Recurrence Arguments
Допустимые значения: Daily, Monthly, Weekly
--schedule-start-datetime

Дата начала правила. Формат: "ГГГГ-MM-DD чч:мм:сс".

Свойство Значение
Группа параметров: Schedule Arguments
--schedule-time-zone

Планирование часового пояса.

Свойство Значение
Группа параметров: Schedule Arguments
Default value: UTC
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az monitor alert-processing-rule delete

Предварительный просмотр

Группа команд "monitor alert-processing-rule" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Удаление правила обработки оповещений.

az monitor alert-processing-rule delete [--ids]
                                        [--name]
                                        [--resource-group]
                                        [--subscription]
                                        [--yes]

Примеры

Удаление правила обработки оповещений.

az monitor alert-processing-rule delete \
--resource-group myResourceGroup \
--name myRuleName

Необязательные параметры

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

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--name -n

Имя правила обработки оповещений.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
--yes -y

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az monitor alert-processing-rule list

Предварительный просмотр

Группа команд "monitor alert-processing-rule" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Список всех правил обработки оповещений в подписке или группе ресурсов.

az monitor alert-processing-rule list [--resource-group]

Примеры

Вывод списка всех правил обработки оповещений в текущей подписке

az monitor alert-processing-rule list

Перечисление всех правил обработки оповещений в группе ресурсов

az monitor alert-processing-rule list \
--resource-group myResourceGroup

Необязательные параметры

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

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az monitor alert-processing-rule show

Предварительный просмотр

Группа команд "monitor alert-processing-rule" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Получение правила обработки оповещений.

az monitor alert-processing-rule show [--ids]
                                      [--name]
                                      [--resource-group]
                                      [--subscription]

Примеры

Получение правила обработки оповещений по имени

az monitor alert-processing-rule show \
--name myRuleName \
--resource-group myRuleNameResourceGroup

Получение правила обработки оповещений по идентификаторам

az monitor alert-processing-rule show \
--ids ruleId1 ruleId2

Необязательные параметры

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

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--name -n

Имя правила обработки оповещений.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az monitor alert-processing-rule update

Предварительный просмотр

Группа команд "monitor alert-processing-rule" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Включение, отключение или обновление тегов для правила обработки оповещений.

az monitor alert-processing-rule update [--add]
                                        [--enabled {false, true}]
                                        [--force-string]
                                        [--ids]
                                        [--name]
                                        [--remove]
                                        [--resource-group]
                                        [--set]
                                        [--subscription]
                                        [--tags]

Примеры

PatchAlertProcessingRule

az monitor alert-processing-rule update \
--name "WeeklySuppression" \
--enabled false \
--tags key1="value1" key2="value2" --resource-group "alertscorrelationrg"

Необязательные параметры

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

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
--enabled

Укажите, включено или отключено ли данное правило обработки (значения — True и False).

Свойство Значение
Допустимые значения: false, true
--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: False
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--name -n

Имя правила обработки оповещений.

Свойство Значение
Группа параметров: Resource Id Arguments
--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False