SuperAPI AI 工具集

tfc-run-status

部署与运维

查看项目

更新于 10-15 23:49

技能介绍

用途:该技能用于查询 Terraform Cloud 中某个已知运行 ID(run ID)的状态,适合在轮询运行、判断通过或失败、以及查看该运行当前可执行哪些操作(确认、取消、丢弃)时使用。它只做状态查询,不读取完整的 plan/apply 日志,也不解析结构化 plan JSON;如需日志、列表或 plan JSON,应改用 tfc-run-logs、tfc-list-runs、tfc-plan-json 等同类技能。

主要能力:通过 Terraform Cloud API 获取运行的状态、消息、创建时间、是否包含变更、是否自动应用等字段;在 include=plan、apply、cost-estimate 时可读取资源新增、变更、销毁数量以及成本估算;可读取状态时间戳(计划时间、应用时间)与可执行操作标记(is-confirmable、is-cancelable、is-discardable、is-force-cancelable),并可输出为 JSON 便于后续处理。

必要用法:先设置环境变量: export TFE_TOKEN="your-api-token" export TFE_ADDRESS="app.terraform.io" 其中 TFE_TOKEN 为用户或团队令牌,TFE_ADDRESS 可选。随后用 curl 携带 Authorization: Bearer 请求 https://app.terraform.io/api/v2/runs/$RUN_ID,可用 jq 提取所需字段。

状态参考:终态包括 applied、planned_and_finished、planned_and_saved、discarded、errored、canceled、force_canceled、policy_soft_failed;进行中状态包括 pending、fetching、queuing、planning、planned、cost_estimating、policy_checking、policy_override、confirmed、apply_queued、applying 等。轮询脚本可循环请求并在状态进入终态后退出。

限制:需要有效的 Terraform Cloud 令牌与网络访问,具体权限受令牌与运行权限约束;资料未提供价格、平台支持范围或与其他版本的兼容性说明。