Skip to content

Invoke 命令

invoke 命令是对线上函数进行调用/触发的命令。

命令解析

当执行命令invoke -h/invoke --help命令时,可以获取帮助文档。

参数解析

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地区,取值范围:cn-hangzhou, cn-beijing, cn-beijing, cn-hangzhou, cn-shanghai, cn-qingdao, cn-zhangjiakou, cn-huhehaote, cn-shenzhen, cn-chengdu, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1
service-name - 选填 必填 服务名
function-name - 选填 必填 函数名
qualifier - 选填 选填 指定调用的版本或者别名
timeout - 选填 选填 客户端调用时间 时间设置原理
event e 选填 选填 事件
event-file f 选填 选填 事件文件
event-stdin s 选填 选填 事件输入
invocation-type - 选填 选填 调用类型,取值范围:async, sync,默认:sync
stateful-async-invocation-id - 选填 选填 有状态的异步调用
sdk-version - 选填 选填 使用旧版的路径调用函数。取值范围:2016-08-15

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s invoke进行线上函数的调用;
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定服务所在地区以及服务名称,函数名等,例如s invoke --region cn-hangzhou --service-name fc-deploy-service --function-name http-trigger-py36

上述命令的执行结果示例:

Request url: https://start-fp-nodejs-hello-wice-test-cturhuznax.cn-shenzhen.fcapp.run/
========= FC invoke Logs begin =========
FC Invoke Start RequestId: 68f15da2-a453-4f7e-90d3-91198b76afbf
FC Invoke End RequestId: 68f15da2-a453-4f7e-90d3-91198b76afbf

Duration: 2.96 ms, Billed Duration: 3 ms, Memory Size: 128 MB, Max Memory Used: 10.83 MB
========= FC invoke Logs end =========

FC Invoke Result[code: ${resp.code}]:
Hello world!

注意事项

在进行调用时,如果需要指定相对应的事件,例如 oss 的事件,cdn 的事件......这些事件的格式,可以通过命令s cli fc-event获取:

方法 方法说明 入参示例 命令行调用示例
http HTTP 触发器事件 s cli fc-event http
cdn CDN 触发器事件 s cli fc-event cdn
mns MNS 触发器事件 s cli fc-event mns
oss OSS 触发器事件 s cli fc-event oss
sls SLS 触发器事件 s cli fc-event sls
tablestore TableStore 触发器事件 s cli fc-event tablestore

例如:如果使用 oss 的事件,进行测试,此时可以执行:s cli fc-event oss,完成之后,可以看到系统提醒的相对路径信息:

...

👓 Event Template Path: event-template/oss-event.json

...

此时,可以利用该路径的模板(可以额外进行修改)触发函数,例如:s invoke --event-file event-template/oss-event.json

权限与策略说明

  • 最大权限: AliyunFCInvocationAccess 或者 AliyunFCFullAccess

  • 最小权限:

{
  'Version': '1',
  'Statement':
    [
      {
        'Action': 'fc:InvokeFunction',
        'Effect': 'Allow',
        'Resource': 'acs:fc:<region>:<account-id>:services/<serviceName>.<qualifier>/functions/<functionName>',
      },
    ],
}