GitHub Actions API 更新简化开发者工作流程追踪

Peter Zhang 2026年2月19日 23:29

GitHub 的工作流程调度 API 现在返回运行 ID，消除了在程序化触发自动化工作流程时对自定义轮询解决方案的需求。

GitHub 已悄然解决了开发者自动化其 CI/CD 管道时更令人烦恼的痛点之一。工作流程调度 API 端点现在直接在其响应中返回运行 ID——这一小变化消除了数小时的变通代码。

以前,通过 API 触发工作流程只会给你一个 204 No Content 状态。你知道工作流程已启动,但如果不重复轮询 API 或构建自定义追踪系统,就很难弄清楚哪个运行是你的。这个问题现在已经解决。

该更新于2026年2月19日宣布,引入了一个名为 return_run_details 的新可选参数。将其设置为 true,你将获得包含工作流程 ID、API URL 和工作流程 URL 的 200 OK 响应。跳过该参数,旧的 204 行为将继续——向后兼容性得以保留。

运行版本 2.87.0 或更高版本的 GitHub CLI 用户会自动获得此功能。执行 gh workflow run,你将看到创建的运行 URL 以及用于检查它的 gh run view 命令。CLI 现在默认将 return_run_details 设置为 true。

这对于在 GitHub Actions 之上构建自动化的任何人都很重要。想想部署编排系统、批处理管道,或任何需要追踪其生成内容的工具。以前的方法——轮询运行端点并尝试匹配时间戳或提交 SHA——既脆弱又消耗速率限制。

时机值得注意。GitHub 仅在两天前的2月17日预览了其 Agentic Workflows 概念,表明对程序化工作流程控制的更深入投资。而且该平台仍在从2月2日影响托管运行器的重大故障中恢复声誉,该故障扰乱了整个生态系统的 CI/CD 管道。

作为背景,GitHub 早在2025年12月就将最大 workflow_dispatch 输入从 10 个增加到 25 个,这是针对复杂自动化场景的另一项生活质量改进。

该功能现已在 REST API 中上线。文档可在 GitHub 的 Actions 工作流程事件指南中找到,供任何准备放弃其自定义追踪技巧的人使用。

• github actions
• api
• devops
• 自动化
• 开发者工具