# 毎日午前9時に実行するcronジョブを作成
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 * * *" }'
# エントリーが無効化されました
必要なすべてのパターン
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 at 9 AM",
"enabled": true
}
生の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エンドポイント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