tcb fn trigger create
按照 cloudbaserc.json 中的配置创建定时触发器。
语法
# 创建指定函数的触发器
tcb fn trigger create <functionName>
# 创建配置文件中所有函数的触发器
tcb fn trigger create
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
[functionName] | 否 | 函数名称,不传时处理配置文件中的全部函数 | — |
-e, --env-id <envId> | 否 | 环境 ID | 取当前默认环境 |
--yes | 否 | 跳过交互确认 | — |
示例
# 为 app 函数创建触发器
tcb fn trigger create app
# 为所有函数创建触发器
tcb fn trigger create
# 在自动化脚本中跳过确认
tcb fn trigger create app -e envId --yes
Cron 表达式
Cron 表达式包含七个必需字段,以空格分隔:
| 字段位置 | 字段名称 | 取值范围 | 支持的通配符 |
|---|---|---|---|
| 第一位 | 秒 | 0~59 | , - * / |
| 第二位 | 分钟 | 0~59 | , - * / |
| 第三位 | 小时 | 0~23 | , - * / |
| 第四位 | 日 | 1~31 | , - * / |
| 第五位 | 月 | 1~12 或 JAN~DEC | , - * / |
| 第六位 | 星期 | 0~6 或 MON~SUN,0 表示周日 | , - * / |
| 第七位 | 年 | 1970~2099 | , - * / |
通配符含义:
| 通配符 | 含义 | 示例 |
|---|---|---|
, | 并集 | 小时字段 1,2,3 表示 1 点、2 点和 3 点 |
- | 范围 | 日字段 1-15 表示 1 号到 15 号 |
* | 全部值 | 小时字段 * 表示每个小时 |
/ | 增量 | 分钟字段 1/10 表示从第 1 分钟起每隔 10 分钟 |
常用写法:
*/5 * * * * * * 每 5 秒触发一次
0 0 2 1 * * * 每月 1 日凌晨 2 点触发
0 15 10 * * MON-FRI * 周一到周五每天上午 10:15 触发
0 0 10,14,16 * * * * 每天 10 点、14 点、16 点触发
0 */30 9-17 * * * * 每天 9 点到 17 点之间每半小时触发
0 0 12 * * WED * 每周三中午 12 点触发
注意事项
- 一个函数目前只能配置一个触发器
- CLI 读取
cloudbaserc.json中的触发器配置执行创建,配置文件中没有触发器配置时创建失败 - Cron 表达式中“日”和“星期”同时指定值时,两者为“或”关系
相关命令
- 删除触发器
- 函数配置 · 触发器:
triggers字段写法