SuperAPI AI 工具集

tfc-list-runs

部署与运维

查看项目

更新于 10-15 23:49

技能介绍

用途:列出并筛选 Terraform Cloud(TFC)工作区的运行记录,支持按状态、操作类型、来源、时间范围等条件过滤,适合查看运行历史、查找失败运行或审计。

主要能力:列出单个工作区或整个组织的运行;按状态(如 errored、canceled)、状态组(non_final、final、discardable)、操作类型(plan_and_apply、plan_only、destroy 等)、来源、时间范围过滤;按 VCS 用户名或提交 SHA 搜索;支持分页与格式化输出(表格或 JSON)。默认不包含 plan-only 运行,需显式指定操作类型才会包含。

使用方式:需先设置环境变量 TFE_TOKEN(用户或团队令牌),可选 TFE_ADDRESS(默认 app.terraform.io)。通过 curl 调用 TFC API v2 的 /runs 端点,配合 jq 解析输出。示例:curl -sf --header "Authorization: Bearer $TOKEN" "$BASE_URL/workspaces/$WORKSPACE_ID/runs?page[size]=10"。按工作区名称查询需先获取工作区 ID。

适用场景:审查运行历史、定位失败运行、跨组织查看运行、按提交或用户检索运行。

限制:/runs 端点有特殊速率限制,为每分钟 30 次请求(而非多数端点的每秒 30 次),脚本编写时需注意。组织级运行列表信息有限且不提供总数。plan-only 运行默认被排除。需要有效的 TFE_TOKEN 才能访问。

相关技能:tfc-run-logs 获取日志,tfc-run-status 查看单个运行状态,tfc-workspace-runs 为已知工作区提供快捷访问。