调用InvokeFunction接口调用执行函数。
请求头
该接口无特殊请求头,关于公共请求头信息,请参见公共参数。
名称 | 类型 | 是否必选 | 示例 | 描述 |
---|---|---|---|---|
X-Fc-Invocation-Type | String | 否 | Sync |
调用方式。
|
X-Fc-Log-Type | String | 否 | 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 |
调用函数的错误类型。 |
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"
}