使用云函数定时触发功能 - 小程序云

使用方法

调用UpdateFunction接口，通过设置参数TimingTriggerConfig来为云函数设置定时触发配置。

TimingTriggerConfig参数的值为一个cron表达式，例如cron:0 0 * * * *表示每个整点触发。

配置规则仅支持设置cron表达式。

cron表达式使用限制：
- cron表达式必须以cron:开头，中间不能包含多余的空格。
- 当前限制云函数定时触发的频率为每小时最多触发一次，要求cron表达式中的秒和分仅支持配置固定的数字，不支持特殊字符。
- cron表达式不支持配置年。
说明 cron表达式中的日和星期字段同时指定为非*时，两者为或关系，即两者的条件均生效。有一个指定为*，两者为与关系。

cron表达式语法说明：

cron表达式有六个必选字段，以空格分隔。其中，每个字段都有相应的取值范围。


位置	字段	取值	特殊字符
1	秒	0~59。	不支持。
2	分	0~59。	不支持。
3	时	0~23。	逗号（,）、连接号（-）、星号（*）、正斜线（/）。
4	日	1~31。（根据具体每月天数而定）	逗号（,）、连接号（-）、星号（*）、正斜线（/）。
5	月	可填数字1~12或月份对应英文单词前三个字母的大写形式：{JAN\|FEB\|MAR\|APR\|MAY\|JUN\|JUL\|AUG\|SEP\|OCT\|NOV\|DEC}。	逗号（,）、连接号（-）、星号（*）、正斜线（/）。
6	星期	可填数字0~7或星期对应英文单词的前三个字母的大写形式：{MON\|TUE\|WED\|THU\|FRI\|SAT\|SUN}，其中数字0和7都表示周日。	逗号（,）、连接号（-）、星号（*）、正斜线（/）。

特殊字符说明：


特殊字符	含义
逗号（,）	表示列出枚举值。例如：在时字段中 `2,3,4`表示2点、3点和4点。
连接号（-）	表示指定范围的所有值。例如：在日字段中，`1-5`包含指定月份的1号到5号。
星号（*）	表示所有值。例如：在时字段中，`*`表示每个小时。
正斜线（/）	表示起始时间开始触发，然后每隔固定时间触发一次。例如：在分字段中，输入`1/10`以指定从第一分钟开始的每隔十分钟触发一次，第11分钟、第21分钟和第31分钟，以此类推。

在云函数中，通过ctx.args来获取执行参数。以下示例展示了定时触发时获取的参数：

{
  "timingTriggerConfig": "cron:0 0 * * * *",
  "timestamp": 1585670400006
}

其中：