更新时间:2022-12-14 GMT+08:00
分享

定时策略参数

表1 timing 请求参数结构

参数

是否必选

参数类型

描述

type

String

计划任务的类型,使用计划任务时必填。可选类型分别为once(仅执行一次),daily(每日执行),weekly(每周执行),monthly(每月执行)。

枚举值:

  • once
  • daily
  • weekly
  • monthly

timezone

String

用户所处的时区,使用计划任务时必填。精确到分钟。

days_of_week

Array of integers

作业会在一周的哪几天执行,当且仅当计划任务类型为weekly时,该字段需填且必填。1~7分别指代星期一至星期日。

最小值:1

最大值:7

days_of_month

Array of integers

作业会在一个月的哪几天执行,当且仅当计划任务类型为monthly时,该字段需填且必填。1~31分别指代一个月中的1日至31日。

最小值:1

最大值:31

date

String

作业的执行日。当且仅当计划任务类型为once且为频率模式时,该字段需填且必填。格式形如yyyy-MM-dd。

periods

Array of periods objects

时间段模式配置。和frequency字段二选一,不可共存。时间段模式下,至少需指定一个时间段。

frequency

frequency object

频率模式配置。和periods字段二选一,不可共存。

表2 timing periods 请求参数结构

参数

是否必选

参数类型

描述

begin_at

String

单个时间段执行的起始时间,和end_at需成对出现。计划任务类型为once时,格式为yyyy-MM-ddThh:mm:ss,其余计划任务类型时,格式为hh:mm:ss。

end_at

String

单个时间段执行的结束时间,和begin_at需成对出现。计划任务类型为once时,格式为yyyy-MM-ddThh:mm:ss,其余计划任务类型时,格式为hh:mm:ss。

表3 timing frequency 请求参数结构

参数

是否必选

参数类型

描述

interval

Integer

相邻两次执行之间的间隔,频率模式必填。取值范围在5~720之间,单位:分钟。

最小值:5

最大值:720

duration

Integer

单次执行的运行时长,频率模式必填。取值范围在5~720之间,单位:分钟。

最小值:5

最大值:720

begin_at

String

单日内执行的起始时间,选填。格式形如hh:mm:ss。

end_at

String

单日内执行的结束时间,选填。格式形如hh:mm:ss。

分享:

    相关文档

    相关产品