更新时间:2025-08-18 GMT+08:00

使用定时触发器(TIMER)

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

常见应用场景示例:

  • 备份重要数据,例如每7天执行备份数据的函数。
  • 监控服务器状态和资源使用情况,例如每天上午10点执行函数并发送服务器使用报表。

定时触发器概述

定时触发器使用TIMER的计划事件功能,能够根据设定的固定频率(分钟、小时、天数)或指定的Cron表达式规则,定期调用函数,适用于需要定期执行任务的场景。

“拉美-圣保罗一”区域支持为共享函数配置定时触发器。

操作视频

本视频介绍如何在函数中使用定时触发器,并查看函数能否按照设定的频率执行。

约束与限制

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

前提条件

创建函数

创建定时触发器

  1. 登录函数工作流控制台,在左侧的导航栏选择“函数 > 函数列表”。
  2. 选择待配置的函数,单击函数名称进入函数详情页。

    “拉美-圣保罗一”区域支持为共享函数配置定时触发器,单击“共享函数”页签下的函数名称进入函数详情页即可。共享函数相关说明请参考基于RAM共享函数资源

  3. 图1所示,选择“设置 > 触发器”,单击“创建触发器”,弹出“创建触发器”对话框。
    图1 创建触发器
  4. 配置以下参数。
    表2 定时触发器参数说明

    参数

    说明

    取值样例

    触发器类型

    选择“定时触发器 (TIMER)”。

    定时触发器 (TIMER)

    定时器名称

    自定义的定时器名称。支持字母、数字、下划线和中划线,必须以字母开头,且长度不能超过64个字符。

    Timer-fg

    触发规则

    触发器的触发规则,可选择使用“固定频率”或“Cron表达式”。

    • 固定频率:固定时间间隔触发函数,该类型下支持配置单位为分、时、天,每种类型仅支持整数配置,其中分钟支持范围(0,60],小时支持范围(0,24],天支持范围(0,30]。
    • Cron表达式:设置更为复杂的函数执行计划,例如:周一到周五上午08:30:00执行函数等,具体请参见Cron表达式规则

    固定频率

    1分钟

    是否开启

    选择是否开启定时触发器。不开启则不会按照设定频率触发函数。

    开启

    附加信息

    可选参数。

    如果用户配置了触发事件,会将该事件填写到TIMER事件源的“user_event”字段,详情请参见支持的事件源

    -

  5. 单击“确定”,完成定时触发器的创建。

查看函数运行结果

函数的定时触发器创建后,将按配置的触发规则定期执行函数,可以在函数详情页中查看函数运行日志。

  1. 返回函数工作流控制台,在左侧的导航栏选择“函数 > 函数列表”。
  2. 选择“函数”,单击函数名称进入函数详情页。
  3. 选择“监控 > 日志”,查询函数运行日志

Cron表达式规则

函数Cron表达式下支持如下两种配置方式。

  • @every格式

    @every NUnit,其中N表示一个正整数,Unit可以为ns, µs, ms, s, m, h,表示每隔N个Unit时间触发一次函数,如表3所示。

    表3 表达式示例

    表达式

    说明

    @every 30m

    每隔30分钟触发一次函数。

    @every 1h

    每隔1小时触发一次函数。

    @every 2h30m

    每隔2小时30分钟触发一次函数。

  • 标准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

    表6 星期字段取值说明

    星期

    数字

    英文简写

    星期一

    1

    Mon

    星期二

    2

    Tue

    星期三

    3

    Wed

    星期四

    4

    Thu

    星期五

    5

    Fri

    星期六

    6

    Sat

    星期日

    0

    Sun

    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共享函数资源

  1. 登录函数工作流控制台,在左侧的导航栏选择“函数 > 函数列表”。
  2. 选择共享函数页签,单击函数名称进入函数详情页。
  3. 后续创建步骤与普通函数相同,请参考3开始操作。

相关文档