Invoke 命令

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

• 命令解析
  • 参数解析
  • 操作案例
  • 注意事项
• 权限与策略说明

命令解析

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

参数解析

当前命令还支持部分全局参数（例如-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获取：

例如：如果使用 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>',
        },
      ],
  }