Azure DevOps API无法返回迭代团队休息日问题排查

问题描述 #

尝试通过以下curl命令调用Azure DevOps API获取团队迭代的休息日：

uri="https://dev.azure.com/$organization/$project/$team/_apis/work/teamsettings/iterations/$iterationId/teamdaysoff?api-version=7.1"
offdaysResponse=$(curl -s -u :"$pat" -H "Content-Type: application/json" "$uri")

尽管迭代确实存在休息日，但响应中的daysOff数组始终为空：

{
    "_links": {
        "project": {
            "href": "https://dev.azure.com/.../_apis/projects/..."
        },
        "self": {
            "href": "..."
        },
        "team": {
            "href": "..."
        },
        "teamIteration": {
            "href": "..."
        },
        "teamIterations": {
            "href": "..."
        },
        "teamSettings": {
            "href": "..."
        }
    },
    "daysOff": [
    ],
    "url": "..."
}

可能的原因及解决方案 #

• PAT权限不足
  确保你的个人访问令牌（PAT）拥有工作项跟踪(读取)或团队设置(读取)权限。权限不足时，API可能不会报错，但会返回空的daysOff数组。

• 迭代ID格式错误
  确认URL中的$iterationId是迭代的GUID，而非显示名称。可以通过以下API获取正确的迭代GUID列表：

  curl -s -u :"$pat" "https://dev.azure.com/$organization/$project/$team/_apis/work/teamsettings/iterations?api-version=7.1"
  

• 休息日设置位置错误
  该API仅返回团队迭代专属的休息日，不包含项目或组织级别的全局日历假期。若你的休息日是在项目配置或组织设置中添加的，需改为在团队迭代中设置：

  1. 进入Azure DevOps团队页面
  2. 打开「迭代」选项卡，选择目标迭代
  3. 在「设置」中添加团队专属的休息日

• API版本兼容性问题
  尝试使用最新的稳定API版本（如7.2-preview.1），确认是否是版本导致的问题：

  uri="https://dev.azure.com/$organization/$project/$team/_apis/work/teamsettings/iterations/$iterationId/teamdaysoff?api-version=7.2-preview.1"
  

• 迭代未关联到团队
  确保目标迭代已添加到当前团队的迭代列表中。即使迭代属于项目，若未与团队关联，API也会返回空数组。

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