# 创建每天早上 9 点运行的定时任务
curl -X POST https://abc123-def456-cron-1.node-us-1.containers.hoody.com/users/root/entries \
-H 'Content-Type: application/json' \
-d '{ "schedule": "0 9 * * *", "command": "/usr/local/bin/backup.sh" }'
# 响应
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"schedule": "0 9 * * *",
"command": "/usr/local/bin/backup.sh",
"enabled": true,
"expires_at": null
}
# 临时禁用任务
curl -X PATCH https://abc123-def456-cron-1.node-us-1.containers.hoody.com/users/root/entries/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-d '{ "schedule": "0 12 * * *" }'
# 条目已禁用
你所需的每种模式
八个表达式及其易读等价形式——直接来自 API 的 schedule_human 字段。
一览调度计划
四个托管条目在滚动轴上呈现——即将触发的条目显示为蓝色，已禁用的条目变暗。由 schedule_human 和 enabled 状态驱动。
daily-backup
02:00
health-check
每 15 分钟
log-rotate
周日 00:00
sync-reports
周一至周五 09:00
托管或原始——随你选择
通过 JSON API 使用 UUID 跟踪的条目（含开关和过期功能），或直接访问 crontab 文件以完全掌控工作流。
托管条目
5 个接口UUID 支持的 CRUD——通过 JSON 创建、读取、更新、删除定时任务。添加注释、切换启用状态、设置自动过期，无需触碰原始 crontab。
# 创建托管条目
POST /users/{user}/entries
{
"schedule": "0 9 * * *",
"command": "/usr/local/bin/backup.sh",
"comment": "Daily backup at 9 AM",
"enabled": true
}
原始 Crontab
3 个接口对每个系统用户的 crontab 文件具有完整读写权限。当需要完全控制或有现有 crontab 工作流时使用此模式。
# 读取原始 crontab
GET /users/{user}/crontab
# 替换整个 crontab
PUT /users/{user}/crontab
{ "crontab": "0 5 * * * /usr/local/bin/backup.sh" }
常用 Cron 表达式
可直接复制粘贴的表达式——每个均经过上方表达式参考验证。
* * * * *
每分钟
每个时钟滴答触发一次，适合持续轮询任务、指标采集器或看门狗进程。
0 * * * *
每小时
每小时整点触发，适合小时摘要、缓存预热或定期 API 同步。
0 9 * * 1-5
工作日早 9 点
仅在周一至周五 09:00 触发，适合发送每日摘要或生成报告等工作时段任务。
0 0 1 * *
每月第一天
每月 1 日午夜触发，适合月度汇总、计费周期和归档任务。
*/5 * * * *
每 5 分钟
每 5 分钟触发，适合健康检查、队列消费和近实时数据同步。
@daily
每日宏
等同于 0 0 * * *——每天午夜触发。表达每日一次调度最简洁的方式。
9 个接口。两种模式。
五个托管条目 CRUD 接口、三个原始 crontab 接口和一个健康检查——均按系统用户作用域隔离。
托管条目
5 个接口https://abc123-def456-cron-1.node-us-1.containers.hoody.com/users/root/entries
原始 Crontab
3 个接口https://abc123-def456-cron-1.node-us-1.containers.hoody.com/users/root/crontab
系统
1 个接口https://abc123-def456-cron-1.node-us-1.containers.hoody.com/health