您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az monitor action-rule

备注

此引用是 Azure CLI 的 alertsmanagement 扩展的一部分,需要 2.3.1 或更高版本。 首次运行 az monitor action-rule 命令时,扩展将自动安装。 详细了解扩展。

用于管理操作规则的命令。

命令

az monitor action-rule create

创建操作规则。

az monitor action-rule delete

删除操作规则。

az monitor action-rule list

列出在给定资源组和给定输入筛选器中创建的订阅的所有操作规则。

az monitor action-rule show

获取操作规则。

az monitor action-rule update

更新操作规则。

az monitor action-rule create

创建操作规则。

az monitor action-rule create --name
                              --resource-group
                              --rule-type {ActionGroup, Diagnostics, Suppression}
                              [--alert-context]
                              [--alert-description]
                              [--alert-rule]
                              [--description]
                              [--location]
                              [--monitor-condition]
                              [--monitor-service]
                              [--scope]
                              [--scope-type {Resource, ResourceGroup}]
                              [--severity]
                              [--status {Disabled, Enabled}]
                              [--suppression-end-date]
                              [--suppression-end-time]
                              [--suppression-recurrence]
                              [--suppression-recurrence-type {Always, Daily, Monthly, Once, Weekly}]
                              [--suppression-start-date]
                              [--suppression-start-time]
                              [--tags]
                              [--target-resource-type]

示例

创建一个操作规则,以在周末取消订阅内所有 VM 上所有 Sev4 警报的通知

az monitor action-rule create --resource-group rg --name rule --location Global --status Enabled --rule-type Suppression --severity Equals Sev4 --target-resource-type Equals Microsoft.Compute/VirtualMachines --suppression-recurrence-type Weekly --suppression-recurrence 0 6 --suppression-start-date 12/09/2018 --suppression-end-date 12/18/2018 --suppression-start-time 06:00:00 --suppression-end-time 14:00:00

创建操作规则,以取消订阅中为 Computer-01 生成的所有日志警报的通知,因为计算机 01 在维护过程中会无限期

az monitor action-rule create --resource-group rg --name rule --location Global --status Enabled --rule-type Suppression --suppression-recurrence-type Always --alert-context Contains Computer-01 --monitor-service Equals "Log Analytics"

创建操作规则以禁止在资源组中显示通知

az monitor action-rule create --resource-group rg --name rule --location Global --status Enabled --rule-type Suppression --scope-type ResourceGroup --scope /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg --suppression-recurrence-type Always --alert-context Contains Computer-01 --monitor-service Equals "Log Analytics"

必需参数

--name -n

操作规则的名称。

--resource-group -g

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

--rule-type

指示操作规则的类型。

接受的值: ActionGroup, Diagnostics, Suppression

可选参数

--alert-context

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

--alert-description

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

--alert-rule

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

--description

操作规则的说明。

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--monitor-condition

按监视条件筛选警报。

--monitor-service

按监视服务筛选警报。

--scope

给定范围 (以) 分隔的 ARM ID 列表,该范围类型将是给定操作规则的目标。

--scope-type

目标范围的类型。

接受的值: Resource, ResourceGroup
--severity

按严重性筛选警报。 所有筛选器都应采用格式"operator value1 value2 ...valueN"。 运算符是 Equals、NotEquals、Contains 和 DoesNotContain 之一。

--status

指示给定操作规则是已启用还是已禁用。 默认为"已启用"。

接受的值: Disabled, Enabled
--suppression-end-date

抑制的结束日期。 格式:MM/DD/YYYY。

--suppression-end-time

抑制的结束时间。 格式:hh:mm:ss。

--suppression-recurrence

按空格分隔的重复模式值列表。 如果 --suppression-recurrence-type 为 Weekly,则允许的值范围为 0 到 6。 0 表示星期日,1 表示星期一,...,6 表示星期六。 如果 --suppression-recurrence-type 为 Monthly,则允许的值范围为 1 到 31,表示月份中的日期。

--suppression-recurrence-type

指定应何时应用抑制。

接受的值: Always, Daily, Monthly, Once, Weekly
--suppression-start-date

抑制的开始日期。 格式:MM/DD/YYYY。

--suppression-start-time

抑制的开始时间。 格式:hh:mm:ss。

--tags

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

--target-resource-type

按目标资源类型筛选警报。

az monitor action-rule delete

删除操作规则。

az monitor action-rule delete --name
                              --resource-group

示例

删除操作规则

az monitor action-rule delete --resource-group rg --name rule

必需参数

--name -n

操作规则的名称。

--resource-group -g

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

az monitor action-rule list

列出在给定资源组和给定输入筛选器中创建的订阅的所有操作规则。

az monitor action-rule list [--action-group]
                            [--alert-rule-id]
                            [--description]
                            [--impacted-scope]
                            [--monitor-service]
                            [--name]
                            [--resource-group]
                            [--severity]
                            [--target-resource]
                            [--target-resource-group]
                            [--target-resource-type]

示例

列出订阅的操作规则

az monitor action-rule list

列出资源组的操作规则

az monitor action-rule list --resource-group rg

可选参数

--action-group

按配置为操作规则一部分的操作组进行筛选。

--alert-rule-id

按警报规则 ID 进行筛选。

--description

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

--impacted-scope

按影响/目标范围筛选器 (为多个作用域提供逗号分隔) 。 该值应为范围构造良好的 ARM ID。

--monitor-service

按生成警报实例的监视服务进行筛选。 默认值为"全选"。

--name

按操作规则名称筛选。

--resource-group -g

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

--severity

按严重性筛选。 默认值为"全选"。

--target-resource

按目标资源组 (为完整 ARM ID) 。 默认值为"全选"。

--target-resource-group

按目标资源组名称进行筛选。 默认值为"全选"。

--target-resource-type

按目标资源类型筛选。 默认值为"全选"。

az monitor action-rule show

获取操作规则。

az monitor action-rule show --name
                            --resource-group

示例

获取操作规则

az monitor action-rule show --resource-group rg --name rule

必需参数

--name -n

操作规则的名称。

--resource-group -g

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

az monitor action-rule update

更新操作规则。

az monitor action-rule update --name
                              --resource-group
                              [--add]
                              [--force-string]
                              [--location]
                              [--remove]
                              [--set]
                              [--status {Disabled, Enabled}]
                              [--tags]

示例

更新操作规则

az monitor action-rule update --resource-group rg --name rule --status Disabled

必需参数

--name -n

操作规则的名称。

--resource-group -g

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

可选参数

--add

通过指定路径和键值对,将 对象添加到 对象列表。 示例:--add property.listProperty <key=value,字符串或 JSON 字符串>。

--force-string

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

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--remove

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

--set

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

--status

指示是启用还是禁用给定操作规则。

接受的值: Disabled, Enabled
--tags

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