Azure DevOps Server 2019：Update Release Environment API无法更新阶段变量

核心问题原因 #

1. 阶段变量更新未生效但API返回成功：
   当阶段处于预部署审批待处理状态时，尽管Releases - Update release environment API返回成功响应，但单独调用该接口更新变量并不会直接生效。该API的设计逻辑是：变量更新需要与审批完成操作绑定，仅更新变量而不触发审批流程的话，阶段变量会保持原始值。

2. 无待审批时调用API报错：
   该API存在明确约束：仅当目标阶段存在待处理的预部署审批时，才能调用它修改阶段属性（包括变量）。若阶段无待审批项（如已完成、已跳过或正在部署），调用时就会触发InvalidRequestException错误。

可行解决方案 #

方案1：结合审批完成操作更新变量 #

调用API时同时传入审批完成的参数，让变量更新与审批流程同步执行。请求体需包含以下关键内容：

• 将status设为inProgress（启动部署流程）
• 在variables中传入待更新的阶段变量键值对
• 可选添加comments字段作为审批备注

示例请求体：

{
  "status": "inProgress",
  "variables": {
    "TargetStageVariable": {
      "value": "NewUpdatedValue",
      "isSecret": false // 根据变量是否为机密值调整
    }
  },
  "comments": "审批通过并更新阶段变量"
}

方案2：先校验审批状态再调用API #

调用更新接口前，先通过Release Approvals - List API检查目标阶段是否存在待处理的预部署审批：

• 过滤条件：匹配目标releaseId、environmentId，且status为pending

仅当存在待审批项时，再执行变量更新操作，避免触发无效请求错误。

方案3：安装服务器最新补丁 #

Azure DevOps Server 2019的Dev17.M153.5属于较早版本，部分API变量更新不生效的问题已在后续补丁中修复。建议检查并安装对应服务器的最新补丁包。

关键注意事项 #

• 阶段变量仅能在预部署审批待处理阶段修改，一旦审批通过或阶段进入部署状态，无法再通过该API变更变量。
• 确保调用API的账号拥有发布审批者和编辑发布的权限，权限不足可能导致接口返回成功但实际未修改变量的情况。

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