如何获取Azure DevOps自定义任务的动态引用ID？

你遇到的问题根源在于：自定义任务安装到Azure DevOps组织后，会生成一个组织专属的动态任务定义ID，而你之前误用了扩展包中固定的任务类型ID，导致API验证失败。下面提供两种可行的解决方法：

方法1：直接用任务名称+版本引用（推荐） #

完全不需要依赖动态ID，直接在Pipeline的步骤配置中通过任务名称和版本范围来引用，系统会自动匹配组织内已安装的对应任务。示例JSON结构如下：

"steps": [
  {
    "task": {
      "name": "你的自定义任务名称",
      "versionSpec": "1.*" // 替换为任务的主版本号，比如2.*、3.*
    },
    "displayName": "自定义任务执行步骤",
    // 这里添加任务的其他配置参数
  }
]

这种方式不仅避开了动态ID的问题，还更灵活——当任务版本更新时，只要版本范围匹配，就能自动使用对应范围内的最新版本。

方法2：通过API获取动态任务定义ID #

如果你的场景必须使用ID引用，可以调用Task Definitions - List API来获取组织内已安装任务的动态ID：

1. 调用API接口：

GET https://dev.azure.com/{你的组织名}/_apis/distributedtask/tasks?api-version=7.1-preview.1

2. 在返回的JSON结果中筛选目标任务：
   • 可以通过type字段匹配扩展包中固定的任务类型ID（也就是你之前错误使用的7f1fe94f-b811-4ba1-9d6a-b6c27de758d7）
   • 或者通过name字段匹配任务的显示名称
3. 找到目标任务后，取其id字段的值，这就是你需要在Pipeline更新API中使用的正确动态ID。

示例PowerShell脚本 #

如果用PowerShell调用API筛选，代码可以这样写：

$orgName = "你的组织名"
$patToken = "你的PAT令牌"
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$($patToken)"))

$tasks = Invoke-RestMethod -Uri "https://dev.azure.com/$orgName/_apis/distributedtask/tasks?api-version=7.1-preview.1" -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)} -Method Get

# 方式1：通过固定任务类型ID筛选
$targetTask = $tasks.value | Where-Object { $_.type -eq "7f1fe94f-b811-4ba1-9d6a-b6c27de758d7" }

# 方式2：通过任务名称筛选
# $targetTask = $tasks.value | Where-Object { $_.name -eq "你的自定义任务名称" }

$dynamicTaskId = $targetTask.id
Write-Host "动态任务引用ID: $dynamicTaskId"

每次重新安装扩展后，调用这个脚本就能获取最新的动态ID，直接用于Pipeline的API更新操作即可。

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