函数计算CFC

    函数调用接口

    调用函数 invocations

    接口描述

    • 本接口用于调用函数。

    请求结构

    POST /v1/functions/{FunctionName}/invocations HTTP/1.1
    Host: cfc.bj.baidubce.com
    Authorization: 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参数调用函数。

    响应头域

    HTTP/1.1 StatusCode
    X-BCE-Function-Error: FunctionError
    X-BCE-Log-Result: LogResult
    
    Payload

    响应参数

    无指定响应参数。

    请求示例

    POST /v1/functions/testHelloworld/invocations HTTP/1.1
    Authorization: Authorization string
    Content-Type: application/json; charset=utf-8
    Host: cfc.bj.baidubce.com
    Content-Length: 49
    
    {
        "key1": "value1",
        "key2": "value2",
        "key3": "value3"
    }

    返回示例

    HTTP/1.1 200 OK
    Content-Type: text/plain; charset=utf-8
    Date: Fri, 15 Mar 2019 05:41:50 GMT
    Server: nginx/1.9.2
    Tracecode: 25104155220692565258031513
    Vary: Accept-Encoding
    X-Bce-Request-Id: 9bccb5e4-94c4-418c-b6da-e52f6c15ab1e
    Content-Length: 18
    Connection: close
    
    Hello world!
    上一篇
    错误返回
    下一篇
    函数操作