如何使用Azure CLI为警报添加操作属性（含webHookProperties）

错误原因分析 #

你遇到的错误源于webHookProperties的传递格式不符合要求：

• 字典键值对需使用**冒号（:）**而非等号（=）
• actions是数组结构，每个元素必须是完整的JSON对象，无法解析你之前的混合格式

正确命令示例 #

方式1：直接添加完整Action对象（推荐） #

通过JSON字符串传递包含actionGroupId和webHookProperties的完整action元素，根据终端环境调整引号转义：

Bash/Zsh环境：

az resource update \
  --name AlertName \
  --resource-group MyResourceGroup \
  --resource-type microsoft.insights/metricAlerts \
  --add properties.actions "[{\"actionGroupId\":\"/subscriptions/9999/resourcegroups/MyResourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup\", \"webHookProperties\":{\"test\":\"data\"}}]"

PowerShell环境：

az resource update `
  --name AlertName `
  --resource-group MyResourceGroup `
  --resource-type microsoft.insights/metricAlerts `
  --add properties.actions '[{"actionGroupId":"/subscriptions/9999/resourcegroups/MyResourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup", "webHookProperties":{"test":"data"}}]'

方式2：分层添加嵌套属性 #

若已有action元素，仅需补充webHookProperties，可通过索引定位数组元素后分步添加：

# 添加actionGroupId到第一个action位置
az resource update \
  --name AlertName \
  --resource-group MyResourceGroup \
  --resource-type microsoft.insights/metricAlerts \
  --add properties.actions[0].actionGroupId "/subscriptions/9999/resourcegroups/MyResourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup"

# 添加webHookProperties的键值对
az resource update \
  --name AlertName \
  --resource-group MyResourceGroup \
  --resource-type microsoft.insights/metricAlerts \
  --add properties.actions[0].webHookProperties.test "data"

批量更新多个警报示例 #

结合az resource list筛选目标警报，循环执行更新命令（Bash环境）：

# 遍历指定资源组下所有指标警报，批量添加action和webHookProperties
for alert_name in $(az resource list --resource-group MyResourceGroup --resource-type microsoft.insights/metricAlerts --query "[].name" -o tsv); do
  az resource update \
    --name $alert_name \
    --resource-group MyResourceGroup \
    --resource-type microsoft.insights/metricAlerts \
    --add properties.actions "[{\"actionGroupId\":\"/subscriptions/9999/resourcegroups/MyResourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup\", \"webHookProperties\":{\"test\":\"data\"}}]"
done

内容的提问来源于stack exchange，提问作者evolmonster