用途:在 Azure DevOps 项目范围内管理 Iteration(Sprint),包括列出项目或团队的 Iteration、依既有节奏创建新 Iteration、将 Iteration 指派给团队。团队为选填,仅在指派或列出特定团队 Iteration 时需要。
主要能力:1) 列出项目 Iteration,读取分类树(classificationnodes/Iterations,%24depth=10),递归展开 children,取 name、path、startDate、finishDate;2) 列出某团队 Iteration(work/teamsettings/iterations),取 name、path、日期与 timeFrame,可加 &%24timeframe=current 只看当前 Sprint;3) 为项目创建 Iteration,先取完整树推算长度、间隔与命名模式,规划后经用户确认再逐一创建,根层省略 {parentPath},否则填父节点相对路径;4) 将 Iteration 指派给团队,用分类节点的 GUID identifier 逐个 POST 到团队 iterations 端点。
使用方式:一律用 curl 直接调用 REST API,每个命令自带验证。组织读环境变量 AZURE_DEVOPS_ORG,PAT 用 -u ":$AZURE_DEVOPS_PAT"(Basic),仅设 AZURE_DEVOPS_EXT_PAT 时改用它,Entra ID 令牌用 -H "Authorization: Bearer $AZURE_DEVOPS_TOKEN"。令牌只从环境变量读取,不贴入对话、不打印、不写文件。路径中的项目、团队、Iteration 名称需 URL 编码(空格 %20),查询串中 $ 写成 %24。Windows PowerShell 用 curl.exe,环境变量写 $env:AZURE_DEVOPS_PAT,JSON 主体先写暂存文件再以 --data-binary "@body.json" 发送。
权限与限制:列出需 Work Items (Read) 与 Project and Team (Read),创建与指派需 Work Items (Read & write)。HTTP 401/403/203 或返回 HTML 登录页表示令牌无效、过期或权限不足,应停止;404 表示组织、项目或团队名称有误。日期以 YYYY/MM/DD 呈现,API 返回 UTC 午夜直接取日期部分,不做时区换算;startDate、finishDate 为 null 时显示(未设定日期),推算节奏只采用有日期的 Iteration。项目 Iteration 路径含 Iteration 层(如 \Contoso\Iteration\Sprint 12),团队 Iteration 与 System.IterationPath 不含该层(如 Contoso\Sprint 12)。