如何通过TeamCity REST API修改运行/已完成构建的参数？

你的操作错误点 #

• 你通过POST /id:{build_id}/log发送服务消息的方式无效，因为这个API端点仅用于追加日志内容，TeamCity不会解析该端点接收的文本中的##teamcity[setParameter]服务消息指令。服务消息仅会被构建进程本身输出的日志内容触发解析，而非通过外部REST API直接提交。

是否可以通过REST API修改构建参数？ #

分两种场景：

• 已完成的构建：参数是只读状态，无法修改，构建完成后参数会被固化为构建结果的一部分。
• 运行中的构建：可以通过REST API修改，但需要使用正确的端点和请求方式：
  1. 目标API端点为构建的特定参数路径：{teamcity_build_api_endpoint}/id:{build_id}/parameters/lock
  2. 使用PUT请求，请求体为XML格式（TeamCity REST API默认接受XML），示例代码：

     params_endpoint = f"{teamcity_build_api_endpoint}/id:{build_id}/parameters/lock"
     payload = '''<value>true</value>'''
     # 需包含认证头及Content-Type头
     headers = {
         'Content-Type': 'application/xml',
         'Authorization': 'Bearer YOUR_TOKEN'  # 替换为你的认证信息
     }
     response = requests.put(params_endpoint, headers=headers, data=payload)
     

关于共享参数锁机制的建议 #

你要实现多构建共享参数的并发控制，不建议直接修改构建参数：

• TeamCity本身没有原生的参数锁机制，直接修改可能存在竞态问题。
• 更可靠的方案是使用TeamCity共享配置参数配合外部分布式锁（比如Redis锁），或者借助TeamCity的构建队列优先级、依赖规则来控制构建执行顺序，避免并发修改冲突。

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