You need to enable JavaScript to run this app. Azure中如何基于Subscription、Region及其他Tag批量更新特定资源Tag
优惠活动
大模型
产品
解决方案
定价
更多

Azure中如何基于Subscription、Region及其他Tag批量更新特定资源Tag

跨Azure资源批量更新指定Tag的可实现方案

完全可以通过Azure CLI、Azure PowerShell完成这类跨类型资源的Tag批量操作,原生支持你提到的三类筛选维度,不需要逐类资源(VM、NSG、应用网关、资源组等)单独编写遍历逻辑,核心是借助Azure Resource Graph的全资源检索能力锁定目标范围,再通过原生资源接口完成Tag更新,覆盖度远高于逐类拉取资源列表的实现方式。

自定义筛选条件的配置规则

两种工具的筛选逻辑完全对齐Azure Resource Graph的查询语法,支持所有你提到的筛选维度,不需要额外适配:

  • 订阅范围:通过资源的subscriptionId字段匹配指定订阅ID,单次查询可覆盖多订阅,不需要反复切换全局登录上下文
  • 区域范围:通过资源的location字段匹配指定的Azure区域值,支持多区域同时筛选
  • 关联Tag取值:通过资源的tags键值对匹配,比如筛选带Environment=Production标签的资源,直接在查询规则中判断对应Tag的取值即可
  • 目标资源定位:额外增加筛选规则,仅保留已经带有你要更新的那个特定Tag的资源,避免给无关联资源误加标签

重要提醒:很多人第一次写批量Tag脚本都会踩这个坑——Azure原生资源接口的Tag更新默认是全量覆盖模式,如果直接传入修改后的单个Tag值,会清除资源上所有原有标签,必须先拉取资源的完整现有Tag集合,仅替换待更新的特定Tag取值后再提交,避免业务标签丢失。PowerShell侧可以用Update-AzTag的Merge操作模式规避这个问题,CLI侧需要配合拉取全量Tag的逻辑做拼接。


Azure CLI 实现步骤

  1. 首次使用需要安装Resource Graph扩展,确保能检索全订阅下的所有资源:
    az extension add --name resourcegraph
    
  2. 先执行查询语句,输出所有匹配筛选规则的资源列表,务必先核对查询命中范围再执行更新,避免误操作:
    az graph query -q "
    Resources
    | where subscriptionId in ('目标订阅ID1', '目标订阅ID2') // 可替换为实际需要筛选的订阅ID列表
    | where location in ('chinaeast', 'chinanorth') // 可替换为实际需要筛选的区域列表
    | where tags['Environment'] == 'Production' // 可替换为实际需要匹配的其他Tag键值
    | where isnotnull(tags['待更新的目标Tag键名']) // 仅筛选已带有待更新Tag的资源
    | project id, name, type, location, subscriptionId
    " --first 1000
    
    如果需要同步覆盖资源组的Tag,需要把查询语句调整为联合资源容器表:
    Resources
    | union resourcecontainers
    | where type == 'microsoft.resources/subscriptions/resourcegroups'
    | 后续筛选规则和之前保持一致
    
  3. 确认查询结果无误后,执行批量更新逻辑:
    # 拉取所有匹配的目标资源ID
    $targetResourceIds = az graph query -q "
    Resources
    | where subscriptionId in ('目标订阅ID1', '目标订阅ID2')
    | where location in ('chinaeast', 'chinanorth')
    | where tags['Environment'] == 'Production'
    | where isnotnull(tags['待更新的目标Tag键名'])
    | project id
    " --query "data[].id" -o tsv
    # 循环逐个更新Tag
    foreach ($resId in $targetResourceIds) {
        # 拉取资源现有全量Tag
        $existingTags = az resource show --ids $resId --query tags -o json
        # 替换目标Tag的取值,比如将CostCenter的取值更新为"1234"
        $updatedTags = $existingTags | jq '.CostCenter = "1234"'
        # 提交更新
        az resource tag --ids $resId --tags $updatedTags
    }
    

Azure PowerShell 实现步骤

  1. 首次使用需要安装ResourceGraph模块,获取全资源检索能力:
    Install-Module -Name Az.ResourceGraph -Force -AllowClobber
    
  2. 先执行查询核对命中的资源范围,确认无误后再执行更新:
    $query = @"
    Resources
    | where subscriptionId in ('目标订阅ID1', '目标订阅ID2')
    | where location in ('chinaeast', 'chinanorth')
    | where tags['Environment'] == 'Production'
    | where isnotnull(tags['待更新的目标Tag键名'])
    | project id, name, type, location, subscriptionId
    "@
    # 拉取匹配的资源列表
    $matchedResources = Search-AzGraph -Query $query -First 1000
    $matchedResources | Format-Table Name, Type, Location
    
    同样,需要覆盖资源组的话,在查询中增加union resourcecontainers | where type == 'microsoft.resources/subscriptions/resourcegroups'规则即可。
  3. 执行批量Tag更新:
    foreach ($resource in $matchedResources) {
        # 获取资源现有完整Tag集合
        $azResource = Get-AzResource -ResourceId $resource.Id
        $tagSet = $azResource.Tags.Clone()
        # 替换目标Tag的取值
        $tagSet["CostCenter"] = "1234"
        # 合并模式提交更新,不会清除原有其他Tag
        Update-AzTag -ResourceId $resource.Id -Tag $tagSet -Operation Merge
    }
    

实操注意事项

  • 分页逻辑:Resource Graph单次查询默认最多返回1000条结果,如果筛选命中的资源量超过1000,需要增加分页循环拉取全量结果,避免漏更新
  • 权限要求:执行操作的账号或服务主体,只需要对目标资源具备Microsoft.Resources/tags/write权限即可,不需要对资源本身拥有增删改的操作权限
  • 避免逐类遍历:如果采用分别拉取VM、NSG、应用网关等资源列表的方式做更新,很容易遗漏后续Azure新增的资源类型,用Resource Graph的方式可以一次覆盖所有订阅下的受管资源,不需要手动维护资源类型清单

内容的提问来源于stack exchange,提问作者KRM

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 18:15:10