调用Azure DevOps RestAPI返回HTML与203状态码问题排查

你遇到的203状态码+返回HTML内容，核心原因集中在PAT权限不足、API路径错误两个方面，结合你的脚本具体分析如下：

1. PAT权限范围不匹配 #

你调用的distributedtask相关API需要PAT具备**Agent Pools (Read)**权限，若你的PAT仅设置了基础项目只读权限，会触发验证失败，返回203跳转页面（而非标准JSON错误）。

• 修复：重新生成PAT时，勾选Agent Pools分类下的Read权限，确保覆盖分布式任务相关API的访问需求。

2. 服务端点URL调用逻辑错误 #

脚本中循环调用$serviceUrl?api-version=$ApiVersion是完全错误的：service.url是服务端点的目标地址（比如Azure资源管理器的https://management.azure.com），并非Azure DevOps的API路径，直接请求第三方服务地址会因PAT无法跨服务验证而返回203。

• 修复：若要获取服务端点的详情，应调用Azure DevOps官方的服务端点详情API，正确URL格式为：

  "https://dev.azure.com/$OrgName/$ProjectName/_apis/distributedtask/serviceendpoints/$serviceId?api-version=$ApiVersion"
  

• 注意：不同类型的服务端点（如AzureRM、GitHub）没有统一的version属性，需要根据service.type针对性提取对应字段。

3. Azure DevOps版本API路径错误 #

你使用的/_apis/distributedtask/server是本地Azure DevOps Server的专属API，不适用于云版本的Azure DevOps Services。云版本应调用组织级别的实例信息API：

• 正确URL："https://dev.azure.com/$OrgName/_apis/instance/info?api-version=$ApiVersion"
• 版本字段在返回结果的value.version下，而非properties.version。

修正后的脚本示例 #

$PAT = "xxxxredactedxxxxx"
$OrgName = "mycompany-devops"
$ProjectName = "MyCompany Infrastructure As Code"
$ApiVersion = "6.0"

# 获取项目下所有服务端点
$services = Invoke-RestMethod -Uri "https://dev.azure.com/$OrgName/$ProjectName/_apis/distributedtask/serviceendpoints?api-version=$ApiVersion" `
    -Method Get `
    -Headers @{Authorization=("Basic {0}" -f [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$PAT")))}

# 遍历服务端点并提取对应信息
foreach ($service in $services.value) {
    $serviceType = $service.type
    $serviceId = $service.id
    $serviceName = $service.name
    
    # 获取服务端点详情
    $serviceDetails = Invoke-RestMethod -Uri "https://dev.azure.com/$OrgName/$ProjectName/_apis/distributedtask/serviceendpoints/$serviceId?api-version=$ApiVersion" `
        -Method Get `
        -Headers @{Authorization=("Basic {0}" -f [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$PAT")))}
    
    # 按服务类型提取对应信息（示例：AzureRM类型）
    if ($serviceType -eq "azurerm") {
        $envVersion = $serviceDetails.data.azureRmEnvironment
        Write-Output "${serviceType}: $serviceName - 环境版本: $envVersion"
    } else {
        Write-Output "${serviceType}: $serviceName - 无统一版本字段，需根据类型自定义提取"
    }
}

# 获取Azure DevOps云版本信息
$azureDevOpsInfo = Invoke-RestMethod -Uri "https://dev.azure.com/$OrgName/_apis/instance/info?api-version=$ApiVersion" `
    -Method Get `
    -Headers @{Authorization=("Basic {0}" -f [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$PAT")))}

Write-Output "Azure DevOps Services版本: $($azureDevOpsInfo.value.version)"

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