ADO构建管道中发布Release Notes至Wiki子页面失败求助

核心问题定位 #

你使用PowerShell脚本调用Azure DevOps Wiki API执行成功，但未在目标Wiki下生成test子页面，核心原因大概率是API路径的path参数格式错误，或是请求配置存在遗漏。

具体排查与修复步骤 #

• 修正API路径的path参数
  Azure DevOps Wiki API的path参数是相对于指定wiki的层级路径，不需要包含根Wiki名称。你当前的路径参数写了PartsUnlimitedWiki/test，但API路径中已经通过wikis/MyDevOpsProject_wiki指定了根Wiki，因此正确的path应该直接写test。修正后的API路径为：

  https://dev.azure.com/xxxx/MyDevOpsProject/_apis/wiki/wikis/MyDevOpsProject_wiki/pages?path=test&api-version=6.0
  

• 验证请求方法与内容

  • 确保脚本使用PUT方法发起请求（GET仅用于查询，无法创建页面）。
  • 确认请求体包含合法的Markdown内容，示例格式：

    $pageContent = @{
      content = "# Test Release Notes`n`n自动生成的发布说明内容"
    } | ConvertTo-Json
    

  • 检查授权令牌（PAT）是否拥有Wiki > Write权限，且请求头正确携带令牌：

    $headers = @{
      "Authorization" = "Bearer $env:SYSTEM_ACCESSTOKEN"
      "Content-Type" = "application/json"
    }
    

• 检查API响应与日志
  查看脚本执行的详细输出，对应响应码的含义：

  • 200/201：页面创建/更新成功
  • 400：参数格式错误（比如路径不符合要求）
  • 401/403：授权令牌无效或权限不足
  • 404：指定的wiki不存在，或父页面（如果是多级子页面）未创建

• 确认父页面存在
  若要创建多级子页面（如parent/test），需确保parent页面已存在；但你当前创建的是根Wiki下的一级子页面，只需确认MyDevOpsProject_wiki对应的根Wiki已存在即可。

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