你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az monitor alert-processing-rule

注意

此参考是 Azure CLI(版本 2.45.0 或更高版本)的警报管理扩展的一部分。 该扩展将在首次运行 az monitor alert-processing-rule 命令时自动安装。 详细了解扩展。

此命令组处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

使用 alertsmanagement 管理警报处理规则。

命令

名称 说明 类型 状态
az monitor alert-processing-rule create

创建警报处理规则。

扩展 预览
az monitor alert-processing-rule delete

删除警报处理规则。

扩展 预览
az monitor alert-processing-rule list

列出订阅或资源组中的所有警报处理规则。

扩展 预览
az monitor alert-processing-rule show

获取警报处理规则。

扩展 预览
az monitor alert-processing-rule update

为警报处理规则启用、禁用或更新标记。

扩展 预览

az monitor alert-processing-rule create

预览

命令组“监视警报处理规则”处于预览状态,正在开发中。 参考和支持级别: 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)期间从特定 VM 上的警报中删除所有操作组的规则。

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 每个星期六和太阳)期间,从两个资源组中的任何 VM 上的所有警报中删除所有操作组)

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"

创建或更新在工作时间之外删除所有操作组的规则(周一-周五 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

范围的资源 ID 列表(空格分隔)。 该规则将应用于在该范围内针对资源触发的警报。

可选参数

--action-groups

要添加的操作组的资源 ID 列表(空格分隔)。 使用此参数要求规则类型为 AddActionGroups。

--description

警报处理规则的说明。

--enabled

指示给定的警报处理规则是启用或禁用的(默认值已启用)。

接受的值: false, true
--filter-alert-context

按警报上下文(有效负载)筛选警报。

筛选器格式是运算符:Equals、NotEquals、Contains、DoesNotContain> 值之一<:要匹配给定条件的值列表。

--filter-alert-rule-description

按警报规则说明筛选警报。

--filter-alert-rule-id

按警报 ID 筛选警报。

--filter-alert-rule-name

按警报规则名称筛选警报。

--filter-monitor-condition

按监视条件筛选警报。

--filter-monitor-service

按监视服务筛选警报。

--filter-resource-group

按资源组筛选警报。

--filter-resource-type

按资源类型筛选警报。

--filter-severity

按严重性 <Sev0、Sev1、Sev2、Sev3、Sev4> 筛选警报。

--filter-signal-type

按信号类型筛选警报。

--filter-target-resource

按资源筛选警报。

--schedule-end-datetime

规则的结束日期。 格式:“YYYY-MM-DD hh:mm:ss”。

--schedule-recurrence

重复模式值列表。

--schedule-recurrence :定期模式值列表(空格分隔)。 对于每周重复类型,允许的值是星期日到星期六。 对于每月重复类型,允许的值为 1 到 31(月中的天数)。

--schedule-recurrence-2

第二个重复模式的重复模式值列表。

--schedule-recurrence-2:重复模式值列表(空格分隔)。 对于每周重复类型,允许的值是星期日到星期六。 对于每月重复类型,允许的值为 1 到 31(月中的天数)。

--schedule-recurrence-2-end-time

每个重复周期的结束时间。 格式:hh:mm:ss。

--schedule-recurrence-2-start-time

每个重复周期的开始时间。 格式:hh:mm:ss。

--schedule-recurrence-2-type

指定何时应应用处理规则。 默认为 Always。

接受的值: Daily, Monthly, Weekly
--schedule-recurrence-end-time

每个重复周期的结束时间。 格式:“hh:mm:ss”。

--schedule-recurrence-start-time

每个重复周期的开始时间。 格式:“hh:mm:ss”。

--schedule-recurrence-type

指定何时应应用处理规则。

接受的值: Daily, Monthly, Weekly
--schedule-start-datetime

规则的开始日期。 格式:“YYYY-MM-DD hh:mm:ss”。

--schedule-time-zone

计划时区。

默认值: UTC
--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor alert-processing-rule delete

预览

命令组“监视警报处理规则”处于预览状态,正在开发中。 参考和支持级别: 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

警报处理规则的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--yes -y

不提示确认。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor alert-processing-rule list

预览

命令组“监视警报处理规则”处于预览状态,正在开发中。 参考和支持级别: 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

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor alert-processing-rule show

预览

命令组“监视警报处理规则”处于预览状态,正在开发中。 参考和支持级别: 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

按 ID 获取警报处理规则

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

可选参数

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

警报处理规则的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor alert-processing-rule update

预览

命令组“监视警报处理规则”处于预览状态,正在开发中。 参考和支持级别: 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>

默认值: []
--enabled

指示给定的处理规则是启用或禁用的(值为 True 和 False)。

接受的值: false, true
--force-string

使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。

默认值: False
--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

警报处理规则的名称。

--remove

从列表中删除属性或元素。 示例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--set

通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=<value>

默认值: []
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。