Path: API › 计划任务

`POST /crontab`

修改日志自动切割任务的配置参数。

## Request body

_Required._

- `action41.request_time` (string, required) — Unix 时间戳。
- `action41.request_token` (string, required) — 按 API 概览生成的签名。
- `action41.action` (string, required) — 具体操作名称。
  - one of `"set_rotate_log"`
- `action41.num` (integer, optional) — 保留日志份数，默认 `10`
- `action41.hour` (string, optional) — 执行时间（时），默认 `2`
- `action41.minute` (string, optional) — 执行时间（分），默认 `0`
- `action41.stype` (string, optional) — 周期类型，默认 `day`
- `action41.log_size` (number, optional) — 日志大小触发值（MB），`0` 不使用大小触发
- `action41.compress` (string, optional) — `"1"` 压缩 / `"0"` 不压缩

## Example request

```text
{
  "request_time": "string",
  "request_token": "string",
  "action": "set_rotate_log",
  "num": 0,
  "hour": "string",
  "minute": "string",
  "stype": "string",
  "log_size": 0,
  "compress": "string"
}
```

## Code samples

### cURL（填写面板地址与签名）

```curl
curl --request POST \
  --url "https://your-panel.example.com:8888/crontab" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>" \
  --data-urlencode "action=set_rotate_log"
```

## Responses

### default

接口响应，业务状态见下方详细说明。

#### Example

```json
{
  "status": true,
  "msg": "修改成功"
}
```


## set_rotate_log

修改日志自动切割任务的配置参数。

**前置条件**：需先通过 [set_rotate_log_status](/api/crontab/set_rotate_log_status) 开启日志切割服务。

- **路由**：`POST /crontab`
- **action**：`set_rotate_log`

## 输入参数

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| action | 是 | String | 固定值 `set_rotate_log` |
| num | 否 | Integer | 保留日志份数，默认 `10` |
| hour | 否 | String | 执行时间（时），默认 `2` |
| minute | 否 | String | 执行时间（分），默认 `0` |
| stype | 否 | String | 周期类型，默认 `day` |
| log_size | 否 | Float | 日志大小触发值（MB），`0` 不使用大小触发 |
| compress | 否 | String | `"1"` 压缩 / `"0"` 不压缩 |

## 示例

```json
{"status": true, "msg": "修改成功"}
```

## 相关接口

- [set_rotate_log_status](/api/crontab/set_rotate_log_status) — 开关日志切割
- [get_rotate_log_config](/api/crontab/get_rotate_log_config) — 查看配置