Actions¶

Actions 用于在仓库里运行流水线（workflow）。通过 API 可以手动触发与重跑流水线，查看运行记录、Job 与日志，管理构建产物（Artifact）以及执行任务的主机／K8S Runner。

本组接口的版本前缀是 /api/v8，不是其他分组的 /api/v5。

对象¶

标识方式¶

• 仓库级接口用 owner + repo；组织级 Runner 接口用 org。
• workflow_id 标识流水线，run_id 标识一次运行，job_id 标识运行内的任务。
• artifact_id 标识构建产物，runner_group_id 标识 Runner 分组。
• 下载 Artifact 时路径里还要带 archive_format（如 zip）。

常见任务¶

注意事项¶

• 版本前缀是 /api/v8：同一套文档里其他分组都是 /api/v5，照抄路径很容易拿不到接口。
• 运行相关三个动作路径不同、语义不同：stop 停止当前运行，rerun 整体重跑，retry 只重试失败任务。
• 手动触发流水线用的是 workflows/{workflow_id}/dispatches（复数 dispatches），与 workflows/validate 这类校验接口都在 workflows/ 下。
• Step 级日志接口是 POST：POST .../runs/{run_id}/jobs/{job_id}/logs；整份日志下载才是 GET .../jobs/{job_id}/download_log。
• Runner 分主机（runners）与 K8S（runner-sets）两套路径，另有「分享给仓库」的 shared-runners / shared-runner-sets。
• 组织级 Runner 相关接口前缀是 /api/v8/orgs/{org}/actions/…，与仓库级 /api/v8/repos/{owner}/{repo}/actions/… 并列。

接口列表¶

本模块共 27 个接口。