调用InvokeFunction接口调用执行函数。

请求头

该接口无特殊请求头，关于公共请求头信息，请参见公共参数。

名称 类型 是否必选 示例 描述
X-Fc-Invocation-Type String 否 Sync

调用方式。

  • Sync：同步调用。
  • Async：异步调用。
X-Fc-Log-Type String 否 None

请求返回日志。

  • Tail：返回当前请求产生的最后4 KB日志。
  • None：默认值，不返回请求日志。
X-Fc-Stateful-Async-Invocation-Id String 否 g6u*****iyvhd3jk8s6bhj0hh

有状态异步调用的ID。

说明 建议您在使用SDK调用时设置与业务相关的ID，方便对相关执行进行后续操作。例如，一个视频处理函数可以使用视频文件名作为调用ID，通过该ID可以查看视频是否处理完成或终止视频的处理。该ID的命名规则只能以英文大小写字母或下划线（_）开头，由英文大小写字母、数字（0-9）、下划线（_）及短划线（-）组成，不超过128个字符。如果您未设置异步调用的ID时，系统则会自动生成一个ID。

请求语法

POST /services/{serviceName.qualifier}/functions/{functionName} HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
serviceName String Path 是 service_name

服务的名称。
qualifier String Path 否 test

服务的版本或别名。
functionName String Path 是 function_name

函数的名称。
String Body 是 event

函数的事件，类型为二进制Byte数组。函数计算将Event传递给用户函数处理。

返回数据

名称 类型 示例值 描述
X-Fc-Error-Type String UnhandledInvocationError

调用函数的错误类型。

  • HandledInvocationError：只有在Node.js中通过callback返回的错误是HandledInvocationError。更多信息，请参见错误处理。
  • UnhandledInvocationError：除了HandledInvocationError，其余的错误都是UnhandledInvocationError。更多信息，请参见错误处理。
X-Fc-Log-Result String demo log result

返回日志结果。
X-Fc-Code-Checksum String 5697641582914695457

函数代码包的CRC-64值。
X-Fc-Stateful-Async-Invocation-Id String g6u*****iyvhd3jk8s6bhj0hh

有状态异步调用的ID。

说明 建议您在使用SDK调用时设置与业务相关的ID，方便对相关执行进行后续操作。例如，一个视频处理函数可以使用视频文件名作为调用ID，通过该ID可以查看视频是否处理完成或终止视频的处理。该ID的命名规则只能以英文大小写字母或下划线（_）开头，由英文大小写字母、数字（0-9）、下划线（_）及短划线（-）组成，不超过128个字符。如果您未设置异步调用的ID时，系统则会自动生成一个ID。
String hello world

调取函数返回的结果，函数具体的返回内容由您定义。

示例

请求示例

POST /services/service_name.test/functions/function_name HTTP/1.1 
公共请求头
 {
   "X-Fc-Invocation-Type":"Sync"
   "X-Fc-Log-Type":"None"
   "X-Fc-Stateful-Async-Invocation-Id":"g6u*****iyvhd3jk8s6bhj0hh"
   "Content-Type":"application/json"
   "body":"event"
}

正常返回示例

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "result" : "hello world"
}