无法通过Azure DevOps REST API为Bug工作项类型添加自定义页面

问题原因 #

继承流程中的系统默认工作项类型（如Bug）若未被自定义过，会处于锁定状态，无法直接修改其布局（包括添加自定义页面），触发VS403115错误。

解决步骤 #

1. 确认锁定状态 #

调用你已使用的获取工作项类型接口，检查返回结果中isLocked字段是否为true，确认Bug类型确实被锁定：

GET https://dev.azure.com/TenantL/_apis/work/processes/6cc6a4ff-e1ea-434d-a6f5-3a21eefeffca/workitemtypes?api-version=7.0

2. 解锁Bug工作项类型 #

有两种方式解锁，优先推荐UI操作（更直观）：

方式一：通过Azure DevOps UI解锁

• 进入组织的组织设置 → 进程
• 找到目标流程（ID：6cc6a4ff-e1ea-434d-a6f5-3a21eefeffca）
• 点击Bug工作项类型进入编辑页，点击页面顶部的解锁按钮，确认解锁后该类型会转为自定义版本，解除锁定限制。

方式二：通过API解锁

发送PATCH请求修改锁定状态：

• 请求URI：

  PATCH https://dev.azure.com/TenantL/_apis/work/processes/6cc6a4ff-e1ea-434d-a6f5-3a21eefeffca/workItemTypes/Microsoft.VSTS.WorkItemTypes.Bug?api-version=7.0
  

• 请求JSON：

  {
    "isLocked": false
  }
  

注意：操作账号需拥有进程管理员权限，否则会触发权限错误。

3. 重新添加自定义页面 #

解锁完成后，重新发送你之前的POST请求，即可成功为Bug类型添加自定义页面：

• 请求URI：

  POST https://dev.azure.com/TenantL/_apis/work/processes/6cc6a4ff-e1ea-434d-a6f5-3a21eefeffca/workItemTypes/Microsoft.VSTS.WorkItemTypes.Bug/layout/pages?api-version=7.0
  

• 请求JSON：

  {
    "sections": [
      {
        "id": "Section1",
        "groups": [],
        "overridden": false
      }
    ],
    "label": "Page1",
    "order": null,
    "overridden": null,
    "inherited": null,
    "visible": true,
    "locked": false,
    "pageType": 1,
    "contribution": null
  }
  

注意事项 #

• 解锁后，该Bug类型将不再自动继承父流程的后续更新，需手动同步父流程的变更
• pageType=1对应自定义页面，参数设置正确，无需修改
• order设为null时，系统会自动将新页面放在布局末尾

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