用途:从 Terraform Cloud(TFC)运行中下载结构化 plan JSON,并对资源变更做程序化分析,例如对比哪些资源将被创建、更新、删除或替换,检查替换原因,或把 plan 数据交给成本、策略、漂移等下游工具。
主要能力:下载指定 run 或 plan 的 JSON 输出;统计 create/update/delete/replace/read/no-op 数量;列出被创建、销毁、更新、替换的资源地址;查看单个资源的 before/after/after_unknown 差异;读取 provider 版本约束、输出值、变量名;也可将 JSON 交给 jq 等工具做进一步处理。
使用方式:先设置环境变量 export TFE_TOKEN="your-api-token",可选 export TFE_ADDRESS="app.terraform.io"。通过 API 端点 /api/v2/runs/<run-id>/plan/json-output 或 /api/v2/plans/<plan-id>/json-output 下载,需使用 curl -L 跟随重定向(API 返回 307)。
适用场景:需要以机器可读方式审计 plan、检查资源替换原因、把 plan 数据接入下游流水线时。若只需人类可读日志、运行状态或列出 run,应改用 tfc-run-logs、tfc-run-status、tfc-list-runs 等同类技能。
限制:需要 Terraform 0.12+ 才支持 JSON 输出;plan 未完成时返回 204 No Content;下载 URL 有效期约 1 分钟;需要工作区管理员权限,401 表示令牌无效或权限不足,404 表示 run 不存在或无权限。具体收费与平台细节暂未提供。