创建http函数-j9九游会登录

如需使用流行web应用框架编写函数代码和构建ai项目，可创建http函数，并根据业务需求完成函数代码、网络配置及函数触发器等必要配置。本章节介绍如何通过控制台创建http函数并提供http使用示例。

functiongraph支持创建空白事件函数和http函数，关于事件函数与http函数的选型对比请参考表1。

表1 事件函数与http函数选型对比
对比项	事件函数	http函数
功能	用于处理文件和数据流，可以通过各类云产品的事件触发，以及用于处理异步请求，能够追踪并保存每个异步调用的状态。	支持流行的web应用框架和ai项目，可以通过浏览器访问，或通过url调用。
适用场景	云产品集成： obs实时文件处理、lts日志加工等。 etl数据加工：数据库数据清洗、消息队列处理等。常规任务：定时任务、周期任务、脚本任务等。多媒体处理：音视频转码、直播录制、图片加工等。	快速构建流行web框架应用：express、flask等。快速构建ai模型推理服务：如stable diffusion、comfyui、deepseek等。迁移已有的应用和接口：html5网站、rest api接口、移动app、小程序、游戏结算等。

http函数概述

http函数专注于优化 web 服务场景，用户可以直接发送http请求到url触发函数执行，从而使用自己的web服务。http函数支持http/1.1协议。

http函数有以下优势：

丰富的框架支持
您可以使用常见的web框架（例如 nodejs web 框架：express、koa）编写http函数，也可以将您本地的web框架服务以极小的改造量快速迁移上云。
减少请求处理环节
函数可以直接接收并处理http请求，api 网关不再需要做json格式转换，减少请求处理环节，提升web服务性能。
编写体验舒适化
http 函数的编写体验更贴近编写原生web服务，可以使用node.js原生接口，保证和本地开发服务体验一致。

http函数公共请求头

http请求头是http协议中用于传递元数据的重要组成部分，在函数调用时可以传递特定的元数据或配置信息，函数默认携带的公共请求头字段如表2所示。

http函数的密钥信息仅能通过请求头传递，如需获取http函数的ak、sk、token，请参考配置http函数的请求头传入密钥。

表2 默认请求头
字段	描述
x-cff-request-id	当前的请求id。
x-cff-memory	函数分配的内存。
x-cff-timeout	函数超时时间。
x-cff-func-version	函数版本。
x-cff-func-name	函数名称。
x-cff-project-id	函数的projectid。
x-cff-package	函数组。
x-cff-region	函数当前所在region。

约束与限制

表3 创建http函数约束限制
限制类别	具体限制
创建函数数量限制	单个账户下最大允许创建的函数个数默认为400个，如需扩大配额请。
http函数限制	http函数当前不区分编程语言，函数执行入口必须在bootstrap文件中设置，用户直接写启动命令，端口统一开放成8000，绑定ip为127.0.0.1。函数需要返回一个合法的http响应报文，用户的http响应体不超过6m。函数的返回合法的http响应报文中必须包含body(string)、statuscode(int)、headers(map)和isbase64encoded(boolean)，http函数会默认对返回结果做base64编码，isbase64encoded默认为true，其它框架同理。 http函数只允许创建apig和apic触发器，其他触发器类型不支持。触发器使用方法请参考使用apig专享版触发器。 http函数不支持长时间运行和异步调用，不支持重试。
其他限制	bootstrap文件是http函数的启动文件，http函数仅支持读取bootstrap作为启动文件名称，其它名称将无法正常启动服务，bootstrap启动文件请参见bootstrap文件示例。若运行jar包，bootstrap中建议增加jvm参数-dfile.encoding=utf-8，否则可能会出现中文乱码。函数发起http请求时，如果是内网访问，则请求ip地址是动态；如果是公网访问，则请求ip地址是固定。如需了解更多关于请求ip地址的详情，请咨询j9九游会登录的技术支持工程师。

前提条件

使用函数工作流控制台的所有操作均默认具有操作权限，请确保您登录的用户已有“functiongraph administrator”权限，即functiongraph服务所有权限，更多权限的说明请参考权限管理。
如果函数工作流服务需要访问云日志服务lts、虚拟私有云vpc等其他云服务进行协同工作，则需创建函数委托并授权函数工作流服务访问所需云服务的权限；若函数工作流服务无需访问其他云服务，则无需创建和选择函数委托。
如果需要配置函数工作流服务访问vpc内资源，请参考创建虚拟私有云和子网创建vpc和子网。

创建http函数

登录，在左侧的导航栏选择“函数 > 函数列表”。
单击右上方的“创建函数”，进入“创建函数”页面。

如图1所示，创建方式选择“创建空白函数”，参考表4配置函数基本信息，参考表5配置函数高级设置参数。

图1 创建http函数基本信息
点击放大

表4 函数基本信息
参数	说明	取值样例
函数类型	选择http函数。处理http请求的函数，可以直接发送http请求到url触发函数执行，从而使用web服务。	http函数
区域	选择函数所在的区域。不同区域的资源之间内网不互通，请就近选择靠近您业务的区域，可以降低网络时延、提高访问速度。	华东-上海一
函数名称	输入自定义的函数名称，命名规则如下：可包含字母、数字、下划线和中划线，长度不超过60个字符。以大/小写字母开头，以字母或数字结尾。	fg-demo
企业项目	选择函数所属的企业项目。企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。默认为“default”，支持用户选择已创建的企业项目。如果您没有开通企业管理服务，将无法看到企业项目选项。开通方法请参见。	default
委托	选择函数的委托。通过委托来授权函数工作流来访问其他云服务，若函数不访问任何云服务，则无需选择委托。默认“未使用任何委托”，支持选择已创建的委托。当华为云账号下无函数默认委托时，functiongraph提供快速创建默认委托“fgs_default_agency”的功能，详情请参见默认委托。	fgs_default_agency
委托权限策略	此参数仅在选择使用委托时显示。选定委托后将展示该委托关联的权限策略，如需调整权限策略，请参考修改函数委托通过iam控制台进行操作。	dis user; swr admin; fgs_default_region_role; fgs_default_global_role

图2 创建函数高级设置参数说明
点击放大

表5 创建函数高级设置参数说明
参数	说明	取值样例
函数访问公网	开启时，函数可以通过默认网卡访问公网上的服务，其公网访问带宽为用户间共享，仅适用于测试场景。	开启
函数访问vpc内资源	开启此参数需要函数配置包含vpc管理权限的委托，若基本信息的委托中选择“未使用任何委托”则无法开启。开启时，函数将使用配置的vpc所绑定的网卡进行网络访问，同时禁用函数工作流的默认网卡，即开关“函数访问公网”参数将不生效。开启后可选择函数需访问的vpc及其子网。	未开启
日志记录	启用日志功能后，函数运行过程中产生的日志会上报到云日志服务（lts）。注意： lts将按需收取日志管理费用，详情请参见。开启后可配置以下参数：日志配置方式自动配置：使用默认日志组和日志流。自定义配置：选择自定义创建的日志组和日志流。日志标签函数执行时，会将日志标签配置上报到lts，可通过标签在lts控制台对函数日志进行过滤筛选，日志标签详情请参见日志管理。标签键/标签值只能包含数字、字母、下划线和中划线，标签最大长度为64。最多支持添加10个标签。	未开启
标签	为函数添加标签，标签用于标识和分类函数资源。添加标签后，可在“函数列表”页面通过标签快速检索和定位函数，便于系统化管理资源。标签与函数资源间为多对多关系，最多支持为单个函数添加20个标签。	-
kms静态加密代码	当前仅“拉美-圣保罗一”区域支持配置该参数。选择是否使用kms静态加密函数代码。注意：密码安全中心dew将按需收取费用，详情请参见。支持选择以下加密类型：（默认）functiongraph/default：函数会在您账号下的dew服务中自动创建默认密钥，您无需手动创建。首次使用该默认密钥进行加解密，需确保函数委托中拥有以下权限：kms:dek:decrypt、 kms:dek:create、 kms:cmk:create、kms:cmk:get、 kms:cmk:list。使用用户主密钥：支持选择已创建的密钥加密函数代码，创建用户主密钥可参考创建自定义密钥。使用用户主密钥，需确保函数委托中拥有以下权限：kms:dek:decrypt、 kms:dek:create、 kms:cmk:get、 kms:cmk:list。注意：若选择“使用用户主密钥”，在后续使用中请勿在dew服务中删除用于函数加密的主密钥，否则将因加密数据无法解密而导致函数执行失败。请参考json视图配置自定义策略前往iam控制台配置函数的委托权限策略。	（默认）functiongraph/default

配置完成后单击“创建函数”，页面跳转至函数详情配置页面，界面上方显示成功创建函数。
完成函数创建后，请参见，根据业务需求完成各项配置，即可使用函数。

http函数使用示例

以下以一个完整的http函数创建和配置示例介绍http函数的使用方法。

在调用api前，请先确保您的业务系统所在网络与api的访问域名或地址互通：

若业务系统与http函数在相同vpc内时，可直接访问api。
若业务系统与http函数在同一区域的不同vpc内时，可通过创建vpc对等连接，将两个vpc的网络打通，实现同一区域跨vpc访问api。具体步骤请参考。
若业务系统与http函数在不同区域的不同vpc内时，可通过创建云连接实例并加载需要互通的vpc，将两个vpc的网络打通，实现跨区域跨vpc访问api。具体步骤请参考跨区域vpc互通。
若业务系统与http函数通过公网互通，请确保http函数已绑定弹性ip。

步骤一：制作代码包

准备一个node脚本文件，命名为“index.js”，代码示例如下：

const http = require('http'); // import node.js core module
 
var server = http.createserver(function (req, res) {   //create web server
    res.writehead(200, { 'content-type': 'text/html' });
    res.write('this is http function.');
    res.end();
});
 
server.listen(8000, '127.0.0.1'); //6 - listen for any incoming requests
 
console.log('node.js web server at port 8000 is running..')

如需解析事件中的body，可参考以下代码示例：

const http = require('http');
const server = http.createserver((req, res) => {
    // 只处理 post 请求（也可以处理 put/patch/delete 等有请求体的方法）
    if (req.url.startswith("/apig-event-template")) {
        let body = '';
        // 1. 监听 'data' 事件收集数据块
        req.on('data', (chunk) => {
            body  = chunk; // 将二进制数据块转为字符串
            // 可选：设置请求体大小限制（防止内存溢出）
            if (body.length > 1e6) { // 1mb
                req.destroy(); // 终止连接
            }
        });
        // 2. 监听 'end' 事件处理完整请求体
        req.on('end', () => {
            try {
                // 根据 content-type 处理不同格式
                const contenttype = req.headers['content-type'] || '';
                // 处理 json 格式
                if (contenttype.includes('application/json')) {
                    const data = json.parse(body);
                    console.log('received json:', data);
                    // 处理表单格式 (url编码)
                } else if (contenttype.includes('application/x-www-form-urlencoded')) {
                    const params = new urlsearchparams(body);
                    const data = object.fromentries(params);
                    console.log('received form data:', data);
                    // 处理普通文本
                } else {
                    console.log('received raw text:', body);
                }
                // 响应客户端
                res.writehead(200, { 'content-type': 'text/plain' });
                res.end('body received');
            } catch (error) {
                // 处理错误（如 json 解析失败）
                console.error('error processing body:', error);
                res.writehead(400, { 'content-type': 'text/plain' });
                res.end('invalid body format');
            }
        });
        // 3. 处理请求错误
        req.on('error', (error) => {
            console.error('request error:', error);
            res.writehead(500, { 'content-type': 'text/plain' });
            res.end('internal server error');
        });
    } else {
        // 处理无请求体的方法
        res.writehead(200, { 'content-type': 'text/plain' });
        res.end('no body needed');
    }
});
// 启动服务器
const port = 8000;
server.listen(port, () => {
    console.log(`server running at http://localhost:${port}`);
});

准备一个bootstrap启动文件，作为http函数的启动文件。
示例：bootstrap文件内容如下。
```
/opt/function/runtime/nodejs12.13/rtsp/nodejs/bin/node $runtime_code_root/index.js
```

将上述两个文件打包为zip文件。

图3 文件打成zip包
点击放大

如果执行http类型是python函数，则bootstrap文件中执行函数时，建议增加“-u”参数确保日志落盘。例如：

/opt/function/runtime/python3.6/rtsp/python/bin/python3 -u $runtime_code_root/index.py

如需使用其他语言，则参考表6更换语言路径，请注意根据使用的运行时语言版本更换路径信息，代码包路径无需更换。

表6 多语言路径说明示例
语言	路径
java21	/opt/function/runtime/java21/rtsp/jre/bin/java
python3.12	/opt/function/runtime/python3.12/rtsp/python/bin/python3
php8.3	/opt/function/runtime/php8.3/rtsp/php/bin/php
c# (.net core 8.0)	/opt/function/runtime/dotnet8.0/rtsp/dotnet/dotnet

步骤二：部署代码包

参考创建http函数创建一个http函数。
在http函数的代码详情页中，单击“上传代码 > zip文件”上传步骤一：制作代码包准备好的zip包。
创建触发器。
1. 选择“设置 > 触发器”页签，单击“创建触发器”。
2. 如图4所示配置触发器信息，此处以创建“api网关服务（apig专享版）”触发器为例，参数详情请参见使用api网关服务（apig专享版）触发器。
  图4 创建触发器
  
  示例中“安全认证”选择“none”，生产环境强烈建议开启app认证或iam认证。
3. 配置完成后，单击“确定”，完成apig触发器创建。
发布api。
1. 单击“触发器”页签下的api名称，跳转至api的总览页面。
  图5 api触发器
2. 单击右上方的“编辑”，进入“基本信息”页面。
  图6 编辑api
3. 修改“路径”参数为“/user/get”并单击“完成”。
  图7 定义api请求
4. 回到api详情界面，单击右上角的“发布最新版本”，在“发布api”页面单击“确定”完成api发布。