API 参考 Crons

创建 cron

POST/projects/{project_id}/cron-jobs/

按 cron 表达式调度元任务。

参数

请求体字段	必填	说明
name	必填	显示名
task_type_id	必填	要派发的元任务
cron_expr	必填	标准五段式 cron 表达式
params	可选	合并进每次运行的固定参数（默认 {}）
enabled	可选	暂停而不删除（默认 true）

请求

curl -X POST "$ALLYBUILD_API_URL/projects/$PROJECT_ID/cron-jobs/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"
  -d '{
    "name": "Monday report",
    "task_type_id": "5f4e3d2c-...",
    "cron_expr": "0 9 * * 1",
    "params": {"month": "2026-10"}
  }'

响应

{
  "id": "1a2b3c4d-...",
  "name": "Monday report",
  "task_type_id": "5f4e3d2c-...",
  "cron_expr": "0 9 * * 1",
  "params": {"month": "2026-10"},
  "enabled": true,
  "next_execution": "2026-10-05T09:00:00Z"
}