InvokeFunction

使用该接口调用指定的函数。

请求语法

POST /2019-09-30/functions/Function/invocations HTTP/1.1
Cookie: Cookie

Payload

请求参数

参数名称 类型 是否必选 描述
Function String 需要调用的函数信息。有如下两种ARN形式。
  • 完整的ARN形式:格式为acs:fc:<yourRegion>:<yourAccountId>:service:<yourServiceName>:function:<yourFunctionName>
  • 部分ARN形式:格式为service:<yourServiceName>:function:<yourFunctionName>
重要 ARN的格式必须符合如下正则表达式模式。

(^acs:fc:([a-z]{2}-[a-z]+(-\d)?)?:(\d{16})?:)?service:([a-zA-Z][\w-]{0,127}):function:([a-zA-Z][\w-]{0,127})$

Cookie String 调用CreateAuthCookie接口创建的认证Cookie。
Payload JSON Payload的内容将原封不动传给函数。

返回语法

HTTP/1.1 StatusCode
X-Fc-Error-Type: ErrorType

Payload

返回参数

参数名称 类型 描述
StatusCode Number HTTP状态码。返回200表示成功,返回其它状态码表示失败。状态码详情请参见状态码
ErrorType String 在函数执行发生错误时出现的参数。有如下两种值。
  • Handled:表示函数上报的错误。
  • Unhandled:表示由函数计算检测并上报的错误,包括函数处理超时或内存不足等错误。
Payload JSON 函数返回的内容,或者返回如下Payload格式所示的错误信息。

返回Payload格式如下所示。

{
    "Message": "string",
    "StackTrace": []
}

完整示例

$ curl -i -b token.cookie -k -X POST https://127.0.0.1:9999/2019-09-30/functions/service:helloworld:function:helloworld/invocations

HTTP/1.1 200 OK
Server: openresty/1.13.6.2
Date: Tue, 19 Nov 2019 09:25:42 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive

HelloWorld