创建 Crontab

创建新的定时任务。

方法

调用方法名为 crontab_create，需要提供以下参数:

{
    "token": "demo_token",
    "name": "task_name",                    // 任务名称
    "cron_expression": "0 * * * *",         // Cron 表达式
    "cron_type": {
        // 任务类型，详情见下文
    }
}

该方法仅用于 创建。如果 name 已存在，会直接返回错误，不会覆盖原有 Crontab。

Cron 表达式

Cron 表达式遵循标准格式，包含秒、分、时、日、月、周字段。

例如：

• 0 * * * * * 表示每小时执行一次
• 0 0 * * * * 表示每天零点执行一次
• 0 0 1 * * * 表示每月1号零点执行一次

Cron 类型

Cron 任务支持两种类型：

Agent 任务类型

在特定 Agent 上执行任务:

{
    "agent": [
        [
            "00000000-0000-0000-0000-000000000001",
            "00000000-0000-0000-0000-000000000002"
        ],
        {
            "task": {
                "ping": "www.example.com"
            }
        }
    ]
}

此示例表示在 UUID 为 00000000-0000-0000-0000-000000000001 和 00000000-0000-0000-0000-000000000002 的 Agent 上执行 ping 任务。

Server 任务类型

在服务器上执行任务:

{
    "server": "clean_up_database"
}

此示例表示执行数据库清理任务。

权限要求

创建 Crontab 需要：

• Crontab::Write
• 若是 Agent 类型，还需要对应任务类型的 Task::Create

并且必须覆盖 cron_type 中声明的 所有 Scope（例如 Agent 列表中的每个 UUID）。

示例权限配置:

{
    "scopes": [
        {"agent_uuid": "00000000-0000-0000-0000-000000000001"},
        {"agent_uuid": "00000000-0000-0000-0000-000000000002"}
    ],
    "permissions": [
        {"crontab": "write"},
        {"task": {"create": "ping"}},
        {"task": {"create": "tcp_ping"}}
    ]
}

返回值

创建成功后返回任务 ID:

{
    "id": 123
}