# 毎日午前9時に実行するcronジョブを作成
hoody cron create root \
--schedule "0 9 * * *" \
--command "/usr/local/bin/backup.sh" \
--comment "Daily backup at 9 AM"
# レスポンス
[
"id": "7d3f2a1b-8c4e-4f9a-b2d5",
"schedule_human": "At 09:00",
"enabled": true
]
# ジョブを一時的に無効化
hoody cron update root $ENTRY_ID --enabled false
# エントリーが無効化されました
必要なすべてのパターン
8つの式とその人間が読みやすい説明 — APIのschedule_humanフィールドと同じ形式。
スケジュールの概要
ローリング軸上の4つの管理エントリー — 青が次回の発火、グレーが無効。
daily-backup
02:00に
health-check
15分ごと
log-rotate
日曜日の00:00に
sync-reports
月〜金の09:00に
管理モードか生モードか — あなたが選ぶ
JSON APIでUUID追跡エントリー（トグルと有効期限付き）、または直接のcrontabアクセス。
管理エントリー
5エンドポイントUUIDバックのCRUD — JSON経由でcronジョブを作成、読み取り、更新、削除。コメント、メタデータ、有効期限を追加。
# 管理エントリーを作成
POST /users/[user]/entries
[
"schedule": "0 9 * * *",
"command": "/usr/local/bin/backup.sh",
"comment": "Daily backup",
"enabled": true,
"expires_at": null
生のCrontab
3エンドポイントシステムユーザーごとのcrontabファイルへのフルアクセス（読み書き）。既存の自動化をそのまま統合する場合に使用。
# 生のcrontabを読み取る
GET /users/[user]/crontab
# crontab全体を置き換える
PUT /users/[user]/crontab
["crontab": "0 5 * * * /usr/local/bin/backup.sh"]
よく使うcron式
ドキュメントに準拠したスケジュール — 式リファレンスで検証済み。
* * * * *
毎分
毎クロックティックで発火。継続的なポーリングタスク、メトリクスコレクターに最適。
0 * * * *
毎時
毎時の先頭で発火。時間ごとのサマリー、キャッシュウォームアップに適切。
0 9 * * 1-5
平日午前9時
月〜金の09:00のみ発火。毎日のダイジェスト送信などビジネス時間タスクに使用。
0 0 1 * *
月の最初
月に1回、1日の深夜0時に発火。月次ロールアップ、請求処理などに最適。
*/5 * * * *
5分ごと
5分ごとに発火。ヘルスチェック、キュードレーナー、ニアリアルタイム同期に便利。
@daily
dailyマクロ
0 0 * * *と同等 — 毎日深夜0時。1日1回を表す最も明確な方法。
9エンドポイント。2つのモード。
5つの管理エントリーCRUDエンドポイント、3つの生のcrontabエンドポイント、1つのヘルスチェック。
管理エントリー
5エンドポイントGET /users/root/entries → [[id, schedule_human, enabled]]
生のCrontab
3エンドポイントPUT /users/root/crontab → [crontab, user]
システム
1エンドポイントGET /health → [status: ok]