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

使用APIG共享版触发器

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

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

约束与限制

  • APIG共享版触发器当前支持“华北-北京一”“华北-北京四”“华东-上海一”“华东-上海二”“华南-广州”“中国-香港”“华北-乌兰察布二零一”“华北-乌兰察布二零二”“亚太-曼谷”“亚太-新加坡”“拉美-圣地亚哥”区域使用。具体运行时函数是否支持使用请以控制台为准。
  • 首次使用API网关的用户不再支持共享版服务,即API网关现已不提供共享版,仅存量用户可继续使用共享版。
  • APIG触发器创建以后,不能停用,只能删除。
  • APIG共享版触发器调用的请求正文有效负载大小为4M。

前提条件

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

创建APIG触发器

  1. 登录函数工作流控制台,在左侧的导航栏选择“函数 > 函数列表”。
  2. 单击右上方的“创建函数”,进入“创建函数”页面。
  3. 选择“创建空白函数”,配置以下函数信息,其他参数保持默认即可。

    • 函数名称:输入自定义的函数名称,例如:apig_test。
    • 企业项目:选择“default”。
    • 委托名称:选择“未使用任何委托”。
    • 运行时语言:选择“Python 2.7”。

  4. 单击“创建函数”,完成函数创建并进入函数详情页。
  5. 在“代码”页签下,复制以下代码至代码编辑区并单击“部署代码”。

    # -*- coding:utf-8 -*-
    import json
    def handler (event, context):
        body = "<html><title>Functiongraph Demo</title><body><p>Hello, FunctionGraph!</p></body></html>"
        print(body)
        return {
            "statusCode":200,
            "body":body,
            "headers": {
                "Content-Type": "text/html",
            },        
            "isBase64Encoded": False
        }

  6. 选择“设置 > 触发器”,单击“创建触发器”,弹出“创建触发器”对话框。

    图1 创建触发器

  7. 配置以下参数。

    表1 APIG触发器参数说明

    参数

    说明

    取值样例

    触发器类型

    必选参数。

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

    API网关服务(APIG)

    API名称

    必选参数。

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

    API_apig

    分组

    必选参数。

    选择API分组。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

    请求方法

    必选参数。

    请求方法有以下类型:

    • GET
    • POST
    • DELETE
    • PUT
    • PATCH
    • HEAD
    • OPTIONS
    • ANY

    ANY

    后端超时(毫秒)

    必选参数。

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

    5000

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

    API触发器创建完成后,会在API网关生成名为API_apig的API,单击API名称,会跳转至API网关服务。

调用函数

  1. 图2所示复制APIG触发器的调用URL,打开任意浏览器,在地址栏中输入调用地址并访问。

    图2 复制APIG调用URL

  2. 函数执行完毕,得到返回结果,如图3所示。

    图3 返回结果

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

相关文档

    提示

    您即将访问非华为云网站,请注意账号财产安全