使用定时触发器（TIMER）
本节介绍如何通过函数工作流控制台创建定时触发器（TIMER），实现按照设置的频率定期触发函数运行。
常见应用场景示例：
- 备份重要数据，例如每7天执行备份数据的函数。
- 监控服务器状态和资源使用情况，例如每天上午10点执行函数并发送服务器使用报表。
定时触发器概述
定时触发器使用TIMER的计划事件功能，能够根据设定的固定频率（分钟、小时、天数）或指定的Cron表达式规则，定期调用函数，适用于需要定期执行任务的场景。
“拉美-圣保罗一”区域支持为共享函数配置定时触发器。
定时触发器的示例事件
- 定时触发器会按照以下事件格式触发函数，具体参数解释请参考表1。
{ "version": "v2.0", "time": "2023-06-01T08:30:00+08:00", "trigger_type": "TIMER", "trigger_name": "Timer_001", "user_event": "User Event" }
操作视频
本视频介绍如何在函数中使用定时触发器，并查看函数能否按照设定的频率执行。
约束与限制
HTTP函数不支持创建定时触发器。
前提条件
已创建函数。
创建定时触发器
- 登录函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。
- 选择待配置的函数，单击函数名称进入函数详情页。
“拉美-圣保罗一”区域支持为共享函数配置定时触发器，单击“共享函数”页签下的函数名称进入函数详情页即可。共享函数相关说明请参考基于RAM共享函数资源。
- 如图1所示，选择“设置 > 触发器”，单击“创建触发器”，弹出“创建触发器”对话框。
- 配置以下参数。
表2 定时触发器参数说明
参数
说明
取值样例
触发器类型
选择“定时触发器 (TIMER)”。
定时触发器 (TIMER)
定时器名称
自定义的定时器名称。支持字母、数字、下划线和中划线，必须以字母开头，且长度不能超过64个字符。
Timer-fg
触发规则
触发器的触发规则，可选择使用“固定频率”或“Cron表达式”。
- 固定频率：固定时间间隔触发函数，该类型下支持配置单位为分、时、天，每种类型仅支持整数配置，其中分钟支持范围(0，60]，小时支持范围(0，24]，天支持范围(0，30]。
- Cron表达式：设置更为复杂的函数执行计划，例如：周一到周五上午08:30:00执行函数等，具体请参见Cron表达式规则。
固定频率
1分钟
是否开启
选择是否开启定时触发器。不开启则不会按照设定频率触发函数。
开启
附加信息
可选参数。
如果用户配置了触发事件，会将该事件填写到TIMER事件源的“user_event”字段，详情请参见支持的事件源。
-
- 单击“确定”，完成定时触发器的创建。
查看函数运行结果
函数的定时触发器创建后，将按配置的触发规则定期执行函数，可以在函数详情页中查看函数运行日志。
- 返回函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。
- 选择“函数”，单击函数名称进入函数详情页。
- 选择“监控 > 日志”，查询函数运行日志。
Cron表达式规则
函数Cron表达式下支持如下两种配置方式。
- @every格式
@every NUnit，其中N表示一个正整数，Unit可以为ns, µs, ms, s, m, h，表示每隔N个Unit时间触发一次函数，如表3所示。
- 标准Cron表达式
Cron表达式格式要求“秒 分 时 日 月 星期(可选)”，每个字段间以空格隔开，其中各字段说明如表4所示。其中特殊字符的含义说明请参考表7。
表4 Cron表达式字段说明字段
说明
取值范围
允许的特殊字符
CRON_TZ
可选。不设置则默认使用region所在时区。
如果您的任务需要按照特定时区运行，可以通过CRON_TZ指定，例如在北京时间每个月一号的04:00触发函数执行，则可以使用CRON_TZ=Asia/Shanghai 0 0 4 1 * *。
不同地域的时区表达式存在差异，请以实际情况自行查询所需地区的CRON_TZ表达方式，示例可参考表8。
-
-
秒
必选。
0-59
, - * /
分
必选。
0-59
, - * /
时
必选。
0-23
, - * /
日(Day of month)
必选。
1-31
, - * ? /
月
必选。
1-12或者Jan-Dec（英文不区分大小写）如表5所示。
, - * /
星期(Day of week)
可选。
0-6或者Sun-Sat（0表示星期天，英文不区分大小写），如表6所示。
, - * ? /
表5 月份字段取值说明月份
数字
英文简写
1月
1
Jan
2月
2
Feb
3月
3
Mar
4月
4
Apr
5月
5
May
6月
6
Jun
7月
7
Jul
8月
8
Aug
9月
9
Sep
10月
10
Oct
11月
11
Nov
12月
12
Dec
Cron表达式字段特殊字符说明如表7所示。
表7 特殊字符说明特殊字符
含义
说明
*
表示该字段中的所有值。
在“分钟”字段中表示每一分钟都执行。
,
指定多个值（可以不连续）。
在“月”字段中指定“Jan,Apr,Jul,Oct”或者“1,4,7,10”，表示1月，4月，7月和10月，在“星期几”字段中指定“Sat,Sun”或者“6,0”表示周六，周日。
-
指定一个范围。
在“分钟”字段中使用0-3，表示从0分到3分。
?
指定一个或另一个。
仅“日”和“星期几”字段可以指定。例如，如果指定了一个特定的日期，但你不关心该日期对应星期几，那么“星期几”字段就可以使用该特殊字符。
/
表示起步和步幅，n/m表示从n开始，每次增加m。
在“分钟”字段1/3表示在满足其它字段情况下，从时间1分（例如00:01:00）开始，每隔3分钟触发一次。
Cron表达式配置示例如表8所示。
表8 Cron表达式配置示例配置实例
Cron 表达式（以北京时区为例）
每天12点调度函数
CRON_TZ=Asia/Shanghai 0 0 12 * * *
每天12:30调度函数
CRON_TZ=Asia/Shanghai 0 30 12 * * *
每小时的26分，29分，33分调度函数
CRON_TZ=Asia/Shanghai 0 26,29,33 * * * *
周一到周五的每天12:30调度函数
CRON_TZ=Asia/Shanghai 0 30 12 ? * MON-FRI
周一到周五的每天12:00～14:59每5分钟调度函数
CRON_TZ=Asia/Shanghai 0 0/5 12-14 ? * MON-FRI
一月到四月每天12:00调度函数
CRON_TZ=Asia/Shanghai 0 0 12 ? JAN,FEB,MAR,APR *
为共享函数创建定时触发器
“拉美-圣保罗一”区域支持为共享函数配置定时触发器，关于共享函数的相关介绍请参考基于RAM共享函数资源。
相关文档
- 除使用控制台外，函数工作流支持通过API的方式管理函数触发器，详情请参见函数触发器API。
- FunctionGraph中使用定时触发器的最佳实践：使用FunctionGraph函数定时开关华为云ECS。
