本文介绍FC-API组件中触发器相关的命令。
前提条件
- 安装Serverless Devs
- 配置Serverless Devs
- 创建服务
- 创建函数
- 可选:创建存储空间
创建OSS触发器时需要创建存储空间。
说明 OSS Bucket和您的函数需要在同一地域。 - 可选:创建主题
创建MNS触发器时需要创建主题。
- 可选:创建Tablestore触发器时需要完成以下操作:
- 可选:创建CDN触发器时,您需要完成以下操作:
创建触发器
命令格式:
s cli fc-api createTrigger --region <cn-hangzhou> --access <keyname> --props <props> --serviceName <serviceName> --functionName <functionName> --invocationRole <role> --qualifier <version or alias> --triggerName <triggerName> --triggerConfig <triggerconfig> --triggerType <triggertype>
参数说明:
- --region string:指定部署资源的地域。
- --access string:指定使用的密钥别名。
- --props string:配置组件参数。关于props的参数信息,请参见YAML规范。
- --serviceName string:指定服务名称。
- --functionName string:指定函数名称。
- --invocationRole string:触发器调用函数时所需的角色。
- --qualifier string:指定服务的别名或版本。
- --sourceArn string:触发器事件源的ARN。
- --triggerConfig string:触发器配置。
- --triggerName string:指定触发器名称。
- --triggerType string:指定触发器类型。触发器类型支持OSS触发器、日志服务触发器、定时触发器、HTTP触发器、Tablestore触发器、CDN事件触发器和MNS主题触发器。
执行示例:
- macOS操作系统或Linux操作系统
s cli fc-api createTrigger --region cn-hangzhou --serviceName mytest --functionName mytest --triggerName mytrigger --triggerConfig '{"payload": "", "cronExpression": "@every 1m", "enable": true}' --triggerType timer
- Windows操作系统
s cli fc-api createTrigger --region cn-hangzhou --serviceName mytest --functionName mytest --triggerName mytrigger --triggerConfig "{\"payload\": \"\", \"cronExpression\": \"@every 1m\", \"enable\": true}" --triggerType timer
关于创建触发器的API接口的详细信息,请参见CreateTrigger。
删除触发器
命令格式:
s cli fc-api deleteTrigger --region <regionid> --aeecss <accessname> --props <props> --serviceName <serviceName> --functionName <functionName> --triggerName <triggerName>
参数说明:
- --region string:指定部署资源的地域。
- --access string:指定使用的密钥别名。
- --props string:配置组件参数。关于props的参数信息,请参见YAML规范。
- --serviceName string:指定服务名称。
- --functionName string:指定函数名称。
- --triggerName string:指定触发器名称。
执行示例:
s cli fc-api deleteTrigger --region cn-hangzhou --serviceName mytest --functionName mytest --triggerName mytrigger
关于删除触发器的API接口的详细信息,请参见DeleteTrigger。
更新触发器
命令格式:
s cli fc-api updateTrigger --region <regionid> --serviceName <serviceName> --functionName <functionName> --triggerName <triggerName> --triggerConfig <triggerconfig> --triggerType <triggertype>
参数说明:
- --region string:指定部署资源的地域。
- --access string:指定使用的密钥别名。
- --props string:配置组件参数。关于props的参数信息,请参见YAML规范。
- --serviceName string:指定服务名称。
- --functionName string:指定函数名称。
- --invocationRole string:触发器调用函数时所需的角色。
- --qualifier string:指定服务的别名或版本。
- --sourceArn string:触发器事件源的ARN。
- --triggerConfig string:触发器配置。
- --triggerName string:指定触发器名称。
- --triggerType string:指定触发器类型。触发器类型支持OSS触发器、日志服务触发器、定时触发器、HTTP触发器、Tablestore触发器、CDN事件触发器和MNS主题触发器。
执行示例:
- macOS操作系统或Linux操作系统
s cli fc-api updateTrigger --region cn-hangzhou --serviceName mytest --functionName mytest --triggerName mytrigger --triggerConfig '{"payload": "", "cronExpression": "@every 1m", "enable": true}' --triggerType timer
- Windows操作系统
s cli fc-api updateTrigger --region cn-hangzhou --serviceName mytest --functionName mytest --triggerName mytrigger --triggerConfig "{\"payload\": \"\", \"cronExpression\": \"@every 1m\", \"enable\": true}" --triggerType timer
关于更新触发器的API接口的详细信息,请参见UpdateTrigger。
获取触发器配置信息
命令格式:
s cli fc-api getTrigger --region <regionid> --access <accessName> --props <props> --serviceName <serviceName> --functionName <functionName> --triggerName <triggerName>
参数说明:
- --region string:指定部署资源的地域。
- --access string:指定使用的密钥别名。
- --props string:配置组件参数。关于props的参数信息,请参见YAML规范。
- --serviceName string:指定服务名称。
- --functionName string:指定函数名称。
- --triggerName string:指定触发器名称。
执行示例:
s cli fc-api getTrigger --region cn-hangzhou --serviceName mytest --functionName mytest --triggerName mytrigger
关于获取触发器配置信息的API接口的详细信息,请参见GetTrigger。
查询触发器列表
命令格式:
s cli fc-api listTriggers --region <regionid> --access <accessname> --props <props> --serviceName <serviceName> --functionName <functionName> --limit <limit number> --nextToken <nextresult> --prefix <return prefix> --startkey <startkey>
参数说明:
- --region string:指定部署资源的地域。
- --access string:指定使用的密钥别名。
- --props string:配置组件参数。关于props的参数信息,请参见YAML规范。
- --limit string:设置限定此次返回资源的数量。
- --nextToken string:设置用来返回更多结果的令牌。第一次查询时不需要提供这个参数,后续查询的Token从返回结果中获取。
- --prefix string:设置返回资源的名称前缀。
- --startKey string:设定结果从startKey之后(包括startKey)按字母排序的第一个开始返回。
- --serviceName string:指定服务名称。
- --functionName string:指定函数名称。
执行示例:
s cli fc-api listTriggers --serviceName mytest --functionName mytest
关于查询触发器列表的API接口的详细信息,请参见ListTriggers。