团队- cli
整个"TeamCity REST API"作为命令行工具,可以安全地交给AI代理.
npm install --global @eyeauras/teamcity-cli
teamcity-cli profile configure # server URL + access token, asked once
teamcity-cli builds list --job Demo_Tests --branch main --limit 20
为什么
| 完成 | REST描述 TeamCity 2026.1发布的所有449个操作都可以达到:构建,队列,构建配置,项目,VCS,代理,云,用户,服务器管理. |
| 默认只读 | 新的简介只能读取 。 写作需要 permissions grant Update 该配置文件; 账户和服务器管理需要 Admin,符号和秘密工作流程需要 Credentials,每个分别授予. |
| 为建造分解而制造 | builds diagnose 在一个电话中回答"为什么它失败":最多10个问题和20个失败测试. jobs run --wait 财务报告和审定财务报表 builds wait 0出站成功,1出站失败,124出站超时,130出站Ctrl+C. |
| 经纪人便宜 | --json 在每一个命令中,页式列表(--limit, (中文(简体) ), --start返回时 hasMore 财务报告和审定财务报表 nextStart,稳定的出错代码,以及持续的 --json-rpc 会话不重新启动节点 . |
| 简介证书 | Profile sidents活在平台秘密商店,从未在Profile JSON中. 写入前置呼叫器输入; 密用别名是可选的 。 密码/ 安全参数返回为 redacted: true,而HTTP出错包括了前4个带有配置证书的服务器文本 KiB. |
| 可预见 | 没有写作被重试或重放 。 当队列请求的答案丢失时, jobs run 报告 run.unknownOutcome 和检查的命令,而不是再次张贴. |
请求发送调用器值和包含文件的列表默认值 。 TeamCity 验证服务值并应用省略字段
默认值。 本地 JSON DTOs 与紧凑选项一起工作;许可门、确认和本地
文档/证书的安全性继续得到执行。 没有过滤器的列表请求其页面中的所有项目
限制:建筑物包括所有分支和州,代理人包括未经授权的代理人.
构建/队列标签列表只包含公共标签和当前用户的私人标签.
使用 builds list --branch @default 或者说 --branch @this 以缩小分支;模板仍分开
从工作。 见 列表默认值 用于扫描界限和范围例外.
覆盖范围
这些操作的每个记录查询参数都由调用者控制;参见 目前REST的覆盖范围。 。 。 .
在449个已公布的REST操作中,每个工具可以通过自己的命令调用,按API区域. 行动覆盖面仍为449/449;0.9.0改进了返回的配置数据,包括完整 0.8.0所隐藏的脚本和平面设置. 矩阵不衡量响应域的完整性.
JetBrains CLI 还有一个原始的 teamcity api 请求此 API 以外的命令和特性
(建立日志,管道,代理终端) 本工具没有. bbox 财务报告和审定财务报表 tctest 为:
小型单用途工具:构建触发和清理,并进行拉取请求的测试运行.
数字、方法和说明: 覆盖面比较。 。 。 .
用这个
# read: why did build 101 fail, as JSON
teamcity-cli builds diagnose 101 --json
# write: allow it for this profile once, then queue a build and wait for the result
teamcity-cli permissions grant Update --profile uat
teamcity-cli jobs run Demo_Tests --profile uat --branch main --wait --timeout 10m
# discover: every level has help
teamcity-cli --help
teamcity-cli builds --help
读取命令返回配置值 TeamCity 提供给您符号, 包括
完整的脚本、 Docker 选项、 要求操作符和 VCS 连接设置。 只有密码类型
参数, secure: teamCity扣留的属性和值保持隐藏.
普通数值,例如 * (圆通配符)和 ***** 仍可读;其拼写不
决定秘密。 编写前传呼叫器提供的名称和值,以供TeamCity验证,包括
密码类型参数和类似证书的值。 读取调度属性 jobs triggers show <job-id> <trigger-id>。 。 。 .
使用 jobs configuration show <job-id> --json 用于构建设置和内容,
projects templates show <template-id> --json 用于模板,以及
agents parameters list <agent-id> --json 用于系统、环境和配置参数.
共享时将真实输出作为私有配置处理 .
使用 --fields <projection> 用于本地TeamCity输出的响应命令。 JSON的终点
接受 fields 接收到它不变; 其他端点返回他们的原生身体而无需额外查询
参数。 名单保留其呼号信封。 默认保留现有摘要和人类观点;
密码/secure:/ 持有的值保持隐藏 。 下载保存本地字节,以及 --store-as 保留
在秘密店里只有秘密回应 REST插件外的 XML 汇总子集返回为文本;
状态 SVG 文件在不解释其内容的情况下被保存.
需要节点.js 22+. 您的服务器版本和您的账户权利仍然决定一个呼叫是什么 允许这样做; 本地许可门并不取代TeamCity自己的授权.