函数工作流 FUNCTIONGRAPH-定制运行时语言:运行时接口说明

时间:2024-09-06 16:06:50

运行时接口说明

FunctionGraph提供了用于自定义运行时的HTTP API来接收来自函数的调用事件,并在FunctionGraph执行环境中发送回响应数据。

  • 获取调用

    方法 – Get

    路径 – http://$RUNTIME_API_ADDR/v1/runtime/invocation/request

    该接口用来获取下一个事件,响应正文包含事件数据。响应标头包含信息如下。

    表1 响应标头信息说明

    参数

    说明

    X-Cff-Request-Id

    请求ID。

    X-CFF-Access-Key

    租户AccessKey,使用该特殊变量需要给函数配置委托。

    X-CFF-Auth-Token

    Token,使用该特殊变量需要给函数配置委托。

    X-CFF-Invoke-Type

    函数执行类型。

    X-CFF-Secret-Key

    租户SecretKey,使用该特殊变量需要给函数配置委托。

    X-CFF-Security-Token

    Security token,使用该特殊变量需要给函数配置委托。

  • 调用响应

    方法 – POST

    路径 – http://$RUNTIME_API_ADDR/v1/runtime/invocation/response/$REQUEST_ID

    该接口将正确的调用响应发送到FunctionGraph。在运行时调用函数处理程序后,将来自函数的响应发布到调用响应路径。

  • 错误上报

    方法 – POST

    路径 – http://$RUNTIME_API_ADDR/v1/runtime/invocation/error/$REQUEST_ID

    $REQUEST_ID为获取事件的响应header中X-Cff-Request-Id变量值,说明请参见表1

    $RUNTIME_API_ADDR为系统环境变量,说明请参见表2

    该接口将错误的调用响应发送到FunctionGraph。在运行时调用函数处理程序后,将来自函数的响应发布到调用响应路径。

support.huaweicloud.com/usermanual-functiongraph/functiongraph_01_0406.html