本文介绍Custom Runtime事件函数的函数判断、函数调用说明和使用示例。

背景信息

在Custom Runtime中,函数计算系统会将Common Headers、Body、POST、/invoke/initialize路径转发给HTTP Server。Common Headers里面的信息可以构造类似官方Runtime中的入参context,而您调用函数的请求体可以构造类似官方Runtime中的入参event

函数调用说明

当函数是事件函数调用时,仅需实现事件函数调用时所实现的Path,即/invoke/initialize
注意 如果创建的函数不设置Initializer,就无需实现/initialize。当不设置时,即使HTTP Server实现了/initialize,代码中的/initialize逻辑也无法被调用执行。
Path 输入请求 预期响应
POST /invoke
  • 请求体:函数输入(InvokeFunction时指定的Payload)。
  • 请求头:Common Request Headers。具体信息,请参见函数计算公共请求头
    注意 Content-Typeapplication/octet-stream
响应体:函数Handler的返回值。
  • StatusCode
    • 200:成功状态。
    • 404:失败状态。
  • Header:x-fc-status
    • 200:成功状态。
    • 404:失败状态。
通过Headers中的x-fc-status响应,向函数计算系统汇报本地函数是否执行成功。
  • 不设置x-fc-status时:函数计算系统默认本次调用是成功执行的,但是您的函数可能有异常,没有向函数计算系统汇报,函数计算系统则会认为这次函数执行没有报错,在业务逻辑上可能没有影响,但是在监控可观测性上会有影响。如下图所示。image8hanshujisuanruntime
  • 设置x-fc-status时:当您的函数存在异常,通过x-fc-status的响应向函数系统汇报本次函数执行失败,并将错误堆栈信息打印到日志中。如下图所示。image9runtimefc
说明 在返回的HTTP响应中,建议您同时设置StatusCode和x-fc-status。
(可选)POST /initialize 响应体:函数Initializer的返回值。
StatusCode
  • 200:成功状态。
  • 404:失败状态。
Python语言中关于initialize的示例代码如下:
@app.route('/initialize', methods=['POST'])
def init_invoke():
    rid = request.headers.get(x-fc-request-id)
    print("FC Initialize Start RequestId: " + rid)
    # do your things
    print("FC Initialize End RequestId: " + rid)
    return "OK"
(可选)GET /pre-freeze 响应体:函数PreFreeze的返回值。
StatusCode
  • 200:成功状态。
  • 404:失败状态。
(可选)GET /pre-stop 响应体:函数PreStop的返回值。
StatusCode
  • 200:成功状态。
  • 404:失败状态。

多语言使用示例

PHP

Go

Node.js

Python

Ruby

C++

TypeScript

Powershell

Lua

Dart

Rust

常见问题