函数调用接口
更新时间：2025-08-03
调用函数 invocations
接口描述
- 本接口用于调用函数。
请求结构
Plain Text
1POST /v1/functions/{FunctionName}/invocations HTTP/1.1
2Host: cfc.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| FunctionName | String | 是 | Path参数 | 您可以指定一个函数名(例如，Thumbnail)，或者您可以指定函数的BRN资源名(例如，brn:bce:cfc:bj:account-id:function:thumbnail:$LATEST)。注意，BRN长度限制1-140。如果只指定函数名，则长度限制为64个字符。 |
| InvocationType | String | 否 | Query参数 | Event(异步调用)返回202/RequestResponse(同步返回)/DryRun(测试函数)。默认RequestResponse。 |
| LogType | String | 否 | Query参数 | 日志类型 Tail / None 您可以将这个可选参数设置为Tail，前提是InvocationType参数必须为RequestResponse。在本例中，CFC在x-bce-log-result头中返回最后4KB的base64编码的日志数据。 |
| Qualifier | String | 否 | Query参数 | 您可以使用这个可选参数来指定CFC函数版本或别名。如果指定一个函数版本，那么API将使用限定的函数BRN来调用特定的CFC函数。如果指定别名，则API使用别名BRN来调用别名指向的CFC函数版本。如果您不提供此参数，那么API将调用$LATEST。 |
自定义参数
自定义函数所需的输入参数，在Body参数以json数据格式传递。会作为input参数调用函数。
响应头域
Plain Text
1HTTP/1.1 StatusCode
2X-BCE-Function-Error: FunctionError
3X-BCE-Log-Result: LogResult
4
5Payload响应参数
无指定响应参数。
请求示例
Plain Text
1POST /v1/functions/testHelloworld/invocations HTTP/1.1
2Authorization: Authorization string
3Content-Type: application/json; charset=utf-8
4Host: cfc.bj.baidubce.com
5Content-Length: 49
6
7{
8 "key1": "value1",
9 "key2": "value2",
10 "key3": "value3"
11}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: text/plain; charset=utf-8
3Date: Fri, 15 Mar 2019 05:41:50 GMT
4Server: nginx/1.9.2
5Tracecode: 25104155220692565258031513
6Vary: Accept-Encoding
7X-Bce-Request-Id: 9bccb5e4-94c4-418c-b6da-e52f6c15ab1e
8Content-Length: 18
9Connection: close
10
11Hello world!