如何用Azure DevOps REST API及PowerShell获取经典发布流水线的YAML定义？

目前Azure DevOps没有提供像经典构建流水线那样直接导出整个经典发布流水线为YAML的REST API，但可以通过PowerShell结合API实现单个任务YAML提取，或自行完成结构转换：

• 获取经典发布定义完整信息
  先调用API拉取发布流水线的全部配置，包含环境、阶段、任务等细节：

  $organization = "你的组织名称"
  $project = "你的项目名称"
  $releaseDefinitionId = "目标发布流水线ID"
  $pat = "你的个人访问令牌（需包含Release权限）"
  $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$($pat)"))
  
  $apiUrl = "https://vsrm.dev.azure.com/$organization/$project/_apis/release/definitions/$releaseDefinitionId?api-version=7.2-preview.7"
  $releaseDefinition = Invoke-RestMethod -Uri $apiUrl -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)} -Method Get
  

• 提取单个任务的YAML定义
  遍历发布定义中的任务，通过任务ID调用API获取元数据，结合任务输入参数生成对应YAML（和UI中查看的单个步骤YAML一致）：

  # 示例：取第一个环境中第一个部署阶段的第一个任务
  $targetTask = $releaseDefinition.environments[0].deployPhases[0].workflowTasks[0]
  $taskMetaUrl = "https://dev.azure.com/$organization/$project/_apis/distributedtask/tasks/$($targetTask.taskDefinitionId)?api-version=7.2-preview.1"
  $taskMetadata = Invoke-RestMethod -Uri $taskMetaUrl -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)} -Method Get
  
  # 拼接任务YAML（核心是结合taskMetadata的yamlFragment和targetTask的inputs参数）
  $taskYaml = "$($taskMetadata.yamlFragment)`n"
  foreach ($input in $targetTask.inputs.GetEnumerator()) {
      $taskYaml += "  $($input.Key): $($input.Value)`n"
  }
  Write-Output $taskYaml
  

• 关键说明

  • 经典发布的多环境、阶段依赖等结构和YAML发布流水线模型差异较大，官方暂未提供一键全量导出API
  • 若需完整转换为YAML发布流水线，需自行编写逻辑，将发布定义中的变量、触发器、环境配置等逐一映射为YAML结构

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