如何使用Azure DevOps API在用户故事(User Story)下创建任务

你可以直接调用同一个_apis/wit/workitems接口完成「创建任务并关联已有用户故事」的操作，核心是在请求体中添加父级关联关系配置，具体步骤如下：

1. 接口调用基础参数 #

• 请求方法：POST
• 请求路径格式：{组织URL}/{项目名}/_apis/wit/workitems/$Task?api-version=6.0
• 请求头必须指定：Content-Type: application/json-patch+json

2. 核心请求体配置 #

你需要在请求的JSON Patch数组中加入一条add操作，指定关联的父用户故事ID，示例结构如下：

[
  // 任务基础字段配置，比如标题、描述等
  {
    "op": "add",
    "path": "/fields/System.Title",
    "value": "你的任务标题"
  },
  // 核心：关联父用户故事的配置
  {
    "op": "add",
    "path": "/relations/-",
    "value": {
      "rel": "System.LinkTypes.Hierarchy-Reverse",
      "url": "{组织URL}/{项目名}/_apis/wit/workitems/{要关联的用户故事ID}",
      "attributes": {
        "comment": "关联到父用户故事"
      }
    }
  }
]

• 这里的System.LinkTypes.Hierarchy-Reverse是Azure DevOps内置的父级关联关系类型，对应把当前创建的任务挂载到指定用户故事的子节点下
• 把占位符{要关联的用户故事ID}替换为你已经创建好的用户故事的实际ID即可

3. 额外说明 #

如果你是要给已经创建好的任务关联已有的用户故事，只需要把请求方法换成PATCH，路径改为对应任务的资源路径{组织URL}/{项目名}/_apis/wit/workitems/{任务ID}?api-version=6.0，请求体只保留上面的关联关系配置段即可调用成功。

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