本文介绍如何在函数计算控制台为目标函数配置定时触发器,包括创建触发器、配置入口参数以及编写函数代码并测试。

前提条件

步骤一:创建定时触发器

  1. 登录函数计算控制台
  2. 在左侧导航栏,单击服务及函数
  3. 在顶部菜单栏,选择地域。
  4. 服务列表页面,找到目标服务,在其右侧操作列单击函数管理
  5. 函数管理页面,单击目标函数名称。
  6. 在函数详情页面,单击触发器管理页签,从版本或别名下拉列表选择要创建触发器的版本或别名,然后单击创建触发器
  7. 在创建触发器面板,填写相关信息。然后单击确定
    参数 操作 本文示例
    触发器类型 选择定时触发器 定时触发器
    名称 填写自定义的触发器名称。 my_trigger
    版本或别名 默认值为LATEST,如果您需要创建其他版本或别名的触发器,需先在函数详情页的右上角切换到该版本或别名。关于版本和别名的简介,请参见管理版本管理别名 LATEST
    触发方式 根据需要选择触发方式:
    • 时间间隔:在时间间隔文本框输入正整数n,表示每n分钟触发一次函数执行。
    • 指定时间:选择时区,并指定日期、星期和时间,表示在某时区的指定时间触发一次函数执行。
    • 自定义:在CRON 表达式文本框中输入Cron表达式,表示按照Cron表达式指定的时间点触发一次函数执行。
    时间间隔:5分钟
    触发消息 输入自定义的参数。该触发消息将会作为event中payload的值。 awesome-fc
    如果您对时区有特殊要求,需要自定义CRON 表达式,请参见如下时间表达式的说明。
    • Cron表达式(UTC时间)

      Cron表达式默认以UTC时间运行,即北京时间减去8个小时。例如北京时间每天12:00调度函数,那么转化为UTC时间就是每天4:00调度函数,则可以使用0 0 4 * * *

    • Cron表达式(北京时间)

      如果您的任务需要按照特定时区运行,可以通过CRON_TZ指定,例如在北京时间每个月一号的04:00触发函数执行,则可以使用CRON_TZ=Asia/Shanghai 0 0 4 1 * *。不同地域的时区表达式存在差异,请以实际情况为准。

      说明

      如果您使用的时区存在夏令时和冬令时的区分,在夏令时和冬令时切换的过程中可能会出现重复执行或少执行的情况,建议将执行时间设置在夏令时和冬令时切换的时间段外。

    创建完成后,在触发器名称列表中显示已创建的触发器。

步骤二:配置函数的入口参数

  1. 在函数详情页面,单击函数代码页签,然后单击xialatubiao图标,从下拉列表中,选择配置测试参数
  2. 配置测试参数面板,选择创建新测试事件编辑已有测试事件页签,填写事件名称和事件内容。然后单击确定

    定时触发器会按照以下event格式来触发函数。

    {
        "triggerTime":"2018-02-09T05:49:00Z",
        "triggerName":"timer-trigger",
        "payload":"awesome-fc"
    }            
    参数 类型 示例值 描述
    triggerTime String 2018-02-09T05:49:00Z 函数被触发的时间。
    triggerName String timer-trigger 定时触发器的名称。
    payload String awesome-fc 您在触发器配置里输入的自定义参数,即触发消息的值。

步骤三:编写函数代码并测试

完成创建定时触发器后,您可以编写函数代码并测试以验证代码的正确性。在实际操作过程中当到达指定的时间时,定时触发器会自动触发函数执行。

  1. 在函数详情页面,单击函数代码页签,在代码编辑器中编写代码,然后单击保存并部署
    本文以Python函数代码为例,示例代码如下。
    import json
    import logging
    
    logger = logging.getLogger()
    
    def handler(event, context):
        logger.info('event: %s', event)
    
        evt = json.loads(event)
        triggerName = evt["triggerName"]
        triggerTime = evt["triggerTime"]
        message = evt["payload"]
        creds = context.credentials
        logger.info('access_key_id: %s', creds.access_key_id)
        logger.info("message = %s", message)                        
  2. 单击函数代码页签的测试函数
    执行完成后,您可以在函数代码页签的上方查看执行结果。

更多信息

除了函数计算控制台,您还可通过以下方式配置触发器:
  • 通过Serverless Devs工具配置触发器。更多操作,请参见Serverless Devs
  • 通过SDK配置触发器。更多操作,请参见SDK列表

如需对创建的触发器进行修改或删除,具体操作,请参见触发器管理