如何通过AZ CLI安全检查资源是否存在，实现脚本幂等性

要实现AZ CLI脚本的幂等性（即资源已存在时跳过创建，不存在时再执行创建），核心是安全判断资源是否存在，避免show命令抛出错误中断脚本。以下是针对动作组及通用资源的解决方案：

一、针对动作组的安全检查方案 #

直接使用az monitor action-group show命令，通过捕获退出码判断资源状态，同时用参数屏蔽冗余输出：

PowerShell 示例 #

# 定义变量
$ActionGroupName = "你的动作组名称"
$ResourceGroupName = "你的资源组名称"
$AGShortName = "你的动作组短名称"

# 检查动作组是否存在
az monitor action-group show `
    --name $ActionGroupName `
    --resource-group $ResourceGroupName `
    --only-show-errors `
    --output none

# 根据退出码判断执行逻辑
if ($LASTEXITCODE -eq 0) {
    Write-Host "动作组 $ActionGroupName 已存在，跳过创建"
} else {
    Write-Host "动作组 $ActionGroupName 不存在，开始创建..."
    az monitor action-group create `
        --name $ActionGroupName `
        --resource-group $ResourceGroupName `
        --short-name $AGShortName
}

Bash 示例 #

# 定义变量
ACTION_GROUP_NAME="your-ag-name"
RESOURCE_GROUP_NAME="your-rg-name"
AG_SHORT_NAME="your-short-name"

# 检查动作组是否存在，存在则返回0，不存在返回非0
if az monitor action-group show --name "$ACTION_GROUP_NAME" --resource-group "$RESOURCE_GROUP_NAME" --only-show-errors --output none; then
    echo "动作组 $ACTION_GROUP_NAME 已存在，跳过创建"
else
    echo "动作组 $ACTION_GROUP_NAME 不存在，开始创建..."
    az monitor action-group create --name "$ACTION_GROUP_NAME" --resource-group "$RESOURCE_GROUP_NAME" --short-name "$AG_SHORT_NAME"
fi

二、通用资源检查方案（适用于所有Azure资源） #

如果需要对其他类型资源做检查，推荐使用az resource show命令，通过指定资源类型实现通用判断：

核心逻辑 #

1. 先确定目标资源的类型（比如动作组的类型是Microsoft.Insights/actionGroups）
2. 用az resource show检查资源，同样通过退出码判断存在性

示例（PowerShell） #

$ResourceName = "你的资源名称"
$ResourceGroupName = "你的资源组名称"
# 替换为对应资源的类型，比如虚拟机是Microsoft.Compute/virtualMachines
$ResourceType = "Microsoft.Insights/actionGroups"

az resource show `
    --name $ResourceName `
    --resource-group $ResourceGroupName `
    --resource-type $ResourceType `
    --only-show-errors `
    --output none

if ($LASTEXITCODE -eq 0) {
    Write-Host "资源 $ResourceName 已存在"
} else {
    # 替换为对应资源的创建命令
    az monitor action-group create `
        --name $ResourceName `
        --resource-group $ResourceGroupName `
        --short-name $AGShortName
}

关键参数说明 #

• --only-show-errors：屏蔽资源不存在时的冗长错误输出，只保留核心错误信息（配合--output none可完全静默输出）
• 退出码判断：AZ CLI命令执行成功返回0，资源不存在或执行失败返回非0（PowerShell用$LASTEXITCODE，Bash直接用命令执行结果判断）
• 资源类型查询：可通过az resource list --query "[].type"查看当前订阅下的所有资源类型，或在Azure门户的资源属性页中找到对应类型

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