更新时间:2025-01-23 GMT+08:00
分享

使用APIG专享版触发器

本节介绍创建APIG触发器,使用API调用函数运行,供您了解APIG触发器的使用方法。APIG专享版触发器创建以后,不能停用,只能删除。(当前除华北-北京一、华北-乌兰察布一外,其余区域均支持。)

本节介绍如何使用函数工作流控制台创建APIG触发器,使用API调用函数运行。

关于APIG触发器事件源的具体介绍,请参见支持的事件源

约束与限制

  • 当前除“华北-北京一”外,其余区域均支持使用APIG专享版触发器。具体运行时函数是否支持使用请以控制台为准。
  • APIG专享版触发器创建以后,不能停用,只能删除。
  • FunctionGraph函数对来自APIG调用的返回结果进行了封装,APIG触发器要求函数的返回结果中必须包含body(String)、statusCode(int)、headers(Map)和isBase64Encoded(boolean),才可以正确返回。
  • APIG专享版触发器调用的请求正文有效负载大小为4M。

前提条件

  • 已创建函数,创建过程请参见创建函数
  • 已创建APIG实例,创建过程请参见创建APIG实例
  • 已创建API分组,此处以APIGroup_test分组为例,创建过程请参见创建API分组

创建APIG触发器

  1. 登录函数工作流控制台,在左侧的导航栏选择“函数 > 函数列表”。
  2. 选择待配置的函数,单击进入函数详情页。
  3. 选择“设置 > 触发器”,单击“创建触发器”,弹出“创建触发器”对话框。

    图1 创建触发器

  4. 配置以下参数。

    表1 APIG专享版触发器参数说明

    参数

    说明

    取值样例

    触发器类型

    必选参数。

    选择“API网关服务(APIG专享版)”。

    API网关服务(APIG专享版)

    实例

    必选参数。

    选择APIG实例。若无实例,可单击“创建实例”完成创建。

    apig-fg

    API名称

    必选参数。

    专享版APIG触发器的名称。支持汉字,英文,数字,下划线,且只能以英文和汉字开头,3-64字符。

    API_apig

    分组

    必选参数。

    选择API分组。API分组相当于一个API集合,API提供方以API分组为单位,管理分组内的所有API。

    若未创建分组,可单击“创建分组”完成创建。

    APIGroup_test

    发布环境

    必选参数。

    选择API的发布环境。API可以同时提供给不同的场景调用,如生产、测试或开发,选择“RELEASE”,才能调用。

    若未创建环境,可单击“创建发布环境”完成创建。

    RELEASE

    安全认证

    必选参数。

    API认证方式有以下三种方式:

    • App: 采用Appkey&Appsecret认证,安全级别高,推荐使用,详情请参见APP认证
    • IAM: IAM认证,只允许IAM用户能访问,安全级别中等,详情请参见IAM认证
    • None: 无认证模式,所有用户均可访问。

    None

    请求协议

    必选参数。

    API的请求协议分为两种类型:

    • HTTP:数据在传输过程中不被加密。
    • HTTPS:数据在传输过程中被加密。

    HTTPS

    后端超时(毫秒)

    必选参数。

    设置API的后端超时时间,单位为毫秒,设置范围为1~60000毫秒。

    5000

  5. 单击“确定”,完成触发器的创建。

    图2 创建触发器
    1. “调用URL”即APIG触发器调用地址。
    2. API触发器创建完成后,会在API网关生成名为API_apig的API,单击API名称,会跳转至API网关服务。

调用函数

  1. 在浏览器地址栏输入APIG触发器的调用地址URL,按“Enter”。
  2. 函数执行完毕,得到返回结果,如图3所示。

    图3 返回结果

    FunctionGraph函数对APIG调用的传入值为函数自带的事件模板,您可以参见表2

查看函数运行结果

  1. 返回函数工作流控制台,在左侧的导航栏选择“函数 > 函数列表”。
  2. 单击函数名称,单击进入函数详情页。
  3. 选择“监控 > 日志”,查询函数运行日志。

相关文档