本文导读

展开导读

文档首页/ 函数工作流 FunctionGraph/ 用户指南/ 配置函数/ 配置函数的触发器/ 使用TIMER定时触发器

使用TIMER定时触发器

更新时间：2025-03-12 GMT+08:00

查看PDF

本节介绍如何通过函数工作流控制台创建定时触发器，实现按照设置的频率定期触发函数运行。

关于定时触发器事件源的具体介绍，请参见支持的事件源。

约束与限制

HTTP函数不支持创建定时触发器。

前提条件

已创建函数。

创建定时触发器

登录函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。
选择待配置的函数，单击进入函数详情页。
如图1所示，选择“设置 > 触发器”，单击“创建触发器”，弹出“创建触发器”对话框。

图1 创建触发器

配置以下参数。

表1 定时触发器参数说明
参数	说明	取值样例
触发器类型	必选参数。选择“定时触发器 (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时间触发一次函数，如表2所示。

表2 表达式示例
表达式	说明
@every 30m	每隔30分钟触发一次函数。
@every 1.5h	每隔1.5小时触发一次函数。
@every 2h30m	每隔2小时30分钟触发一次函数。

标准Cron表达式

Cron表达式格式要求“秒分时日月星期(可选)”，每个字段间以空格隔开，其中各字段说明如表3所示。

表3 Cron表达式字段说明
字段	说明	取值范围	允许的特殊字符
CRON_TZ	可选。不设置则默认使用region所在时区。如果您的任务需要按照特定时区运行，可以通过CRON_TZ指定，例如在北京时间每个月一号的04:00触发函数执行，则可以使用CRON_TZ=Asia/Shanghai 0 0 4 1 * *。不同地域的时区表达式存在差异，请以实际情况为准。	-	-
秒	必选。	0-59	, - * /
分钟	必选。	0-59	, - * /
时	必选。	0-23	, - * /
日(Day of month)	必选。	1-31	, - * ? /
月	必选。	1-12或者Jan-Dec（英文不区分大小写）如表4所示。	, - * /
星期(Day of week)	可选。	0-6或者Sun-Sat（0表示星期天，英文不区分大小写），如表5所示。	, - * ? /

表4 月份字段取值说明
月份	数字	英文简写
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

表5 星期字段取值说明
星期	数字	英文简写
星期一	1	Mon
星期二	2	Tue
星期三	3	Wed
星期四	4	Thu
星期五	5	Fri
星期六	6	Sat
星期日	0	Sun

Cron表达式字段特殊字符说明如表6所示。

表6 特殊字符说明
特殊字符	含义	说明
*	表示该字段中的所有值。	在“分钟”字段中表示每一分钟都执行。
,	指定多个值（可以不连续）。	在“月”字段中指定“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表达式配置示例如表7所示。

表7 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 *

父主题：配置函数的触发器

上一篇：FunctionGraph支持的触发事件

下一篇：使用APIG专享版触发器

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

使用TIMER定时触发器

约束与限制

前提条件

创建定时触发器

查看函数运行结果

Cron表达式规则

@every格式

标准Cron表达式

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈