触发器

收藏
我的收藏

介绍​

抖音云提供了触发器能力,开发者可以通过配置触发器来实现定时性周期任务。​

功能简介​

功能模块​

抖音云触发器分为触发器管理、触发记录两个模块:​
    触发器管理:触发器生命周期中创建、编辑、删除、开启、关闭相关操作。​
    触发记录:查看触发器历史记录信息,一键跳转查询日志。​

使用流程​

    1.服务接口开发:在抖音云服务里定义http post接口,处理触发业务逻辑和输出日志(开发文档)。​
    2.创建触发器:在抖音云控制台新建触发器,配置触发服务、周期。​
    3.触发器执行:触发器根据配置的周期定时调用服务接口,并获取接口返回。​
    4.查看触发记录:每次触发调用后会生成一条触发记录,可以查看该次触发的完整信息,并基于logid快速查询该次调用服务日志。​

使用限制​

    1.触发器数量限制:每个小程序在每个环境下最多创建20个触发器。​
    2.触发记录限制:每个触发器最多保留200条触发记录。​

操作指引​

触发器管理​

新建触发器​

功能项​
说明​
触发器类型​
目前仅支持「定时触发器」​
触发器名称​
    规则名称长度最大为32​
    只包含中文、英文字母、数字、中划线、下划线​
触发服务​
    服务 ​
    需选择已成功部署后的服务​
    接口​
触发周期​
    间隔时间​
    支持直接按不同的间隔时间设置周期​
    周期粒度支持分、时、天​
    设置后将在下一个周期开始运行,如当前12.00设置按 间隔 1 小时的周期,触发器将在一小时后即13.00开始第一次触发​
    常用周期​
    支持按日常常用周期如每N天、每周N、每月N号进行设置​
    粒度支持按天、按周、按月​
    设置后将在下一个符合周期的时期触发,如当前12.00设置 按天 每 1天 00.00.00 的周期,则将在当天晚上00.00.00首次触发​
    cron表达式​
触发参数​
    需按json格式填写自定义参数,填写后将作为http post body调用接口,详见开发文档
开启状态​
    开启状态下即开始根据周期触发,符合周期内的时间点会执行触发​
    关闭状态下不会触发​

触发器列表​

功能项​
说明​
筛选-触发器名称​
根据输入对触发器名称进行模糊搜索​
筛选-状态​
    筛选状态为启用、禁用、失效的触发器​
    失效通常为 服务被删除 时,对应的触发器状态将变为失效​
表格列-触发服务​
点击可跳转查看服务详情​
表格列-周期​
展示不同方式设置的周期​
表格列-开启时间​
展示最近一次开启时间​
操作-状态​
    点击可修改当前开启状态​
    开启状态下触发器才会执行调用​
操作-手动触发​
手动进行一次触发并生成触发记录,支持自定义参数​
操作-编辑​
支持编辑更新触发器周期、触发参数​
操作-删除​
    删除触发器后同步删除该触发器的触发记录​
    关闭触发器后才可删除触发器​

触发记录​

功能项​
说明​
筛选-触发器名称​
根据输入对触发器名称进行模糊搜索​
筛选-触发时间​
选择触发时间范围​
筛选-触发方式​
筛选手动触发、自动触发的记录​
表格列-返回状态​
    【无】​
    触发请求发出未接收到时,hover展示原因:等待返回​
    触发请求超时,也展示为【无】​
    Http code: 触发接口返回时,记录会更新返回状态为对应返回的http状态码​
    失败:出现内部错误时,触发状态为失败,请发起oncall咨询具体原因​
操作-详情​
查看请求参数、日志id等具体信息​
操作-日志​
点击将跳转服务日志查询页面,查询当前触发记录logid关联的日志​