如何删除带有特殊字符的Azure Pipeline构建标签？

核心方案：用PATCH方法覆盖标签列表 #

既然DELETE端点无法处理含特殊字符的标签，直接通过PATCH接口覆盖构建的完整标签列表，移除目标标签即可。以下是具体实现步骤：

1. 单构建标签删除步骤 #

第一步：获取当前构建的标签列表

先调用GET接口拉取构建详情，提取现有标签并过滤掉要删除的目标标签：

$org = "你的组织名称"
$project = "你的项目名称"
$buildId = 1234567
$targetTag = "hello: world"
$pat = "你的PAT令牌"
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat"))

# 获取构建详情
$buildUrl = "https://dev.azure.com/$org/$project/_apis/build/builds/$buildId?api-version=7.1"
$buildResponse = Invoke-RestMethod -Uri $buildUrl -Headers @{Authorization = "Basic $base64AuthInfo"} -Method Get

# 过滤掉目标标签
$updatedTags = $buildResponse.tags | Where-Object { $_ -ne $targetTag }

第二步：发送PATCH请求更新标签

构造仅包含过滤后标签的请求体，发送PATCH请求完成更新：

# 构造请求JSON
$body = @{
    tags = $updatedTags
} | ConvertTo-Json

# 执行更新
$patchUrl = "https://dev.azure.com/$org/$project/_apis/build/builds/$buildId?api-version=7.1"
Invoke-RestMethod -Uri $patchUrl -Headers @{Authorization = "Basic $base64AuthInfo"; "Content-Type" = "application/json"} -Method Patch -Body $body

2. 批量处理脚本示例 #

针对1600+标签的批量需求，可循环遍历构建ID列表（或通过API筛选含目标标签的构建）批量处理：

$org = "你的组织名称"
$project = "你的项目名称"
$targetTag = "hello: world"
$pat = "你的PAT令牌"
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat"))
$apiVersion = "7.1"

# 替换为你的构建ID列表，或通过API查询获取含目标标签的构建ID
$buildIds = @(1234567, 1234568, 1234569, ...)

foreach ($buildId in $buildIds) {
    try {
        # 获取构建标签
        $buildUrl = "https://dev.azure.com/$org/$project/_apis/build/builds/$buildId?api-version=$apiVersion"
        $buildResponse = Invoke-RestMethod -Uri $buildUrl -Headers @{Authorization = "Basic $base64AuthInfo"} -Method Get

        if ($buildResponse.tags -contains $targetTag) {
            # 过滤标签
            $updatedTags = $buildResponse.tags | Where-Object { $_ -ne $targetTag }
            $body = @{ tags = $updatedTags } | ConvertTo-Json

            # 执行更新
            $patchUrl = "https://dev.azure.com/$org/$project/_apis/build/builds/$buildId?api-version=$apiVersion"
            Invoke-RestMethod -Uri $patchUrl -Headers @{Authorization = "Basic $base64AuthInfo"; "Content-Type" = "application/json"} -Method Patch -Body $body

            Write-Host "已移除构建$buildId的标签`"$targetTag`""
        } else {
            Write-Host "构建$buildId不含目标标签`"$targetTag`""
        }
    } catch {
        Write-Host "处理构建$buildId失败：$_"
    }
}

注意事项 #

• 确保你的PAT拥有**Build (Edit)**权限，否则会返回403权限错误
• 批量操作前建议先测试单个构建，确认脚本逻辑正常
• 如果需要自动筛选含目标标签的构建，可调用_apis/build/builds接口并添加tags查询参数

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