本章介绍函数工作流如何创建程序包。 要创建FunctionGraph函数，首先需要创建函数部署程序包（包含代码和所有依赖项的文件）。用户可以自行创建部署程序包或直接在FunctionGraph函数控制台在线编辑代码，控制台将创建并上传部署程序包，从而实现FunctionGraph函数的创建。用户在编辑函数代码时支持类似工程方式的管理，可以创建文件、文件夹并对其进行编辑。如果用户代码是上传zip包的方式，则前端进行相应解压展示，提供编辑能力。 说明 用户在本地开发程序之后打包，必须是ZIP包（Java、Node.js、Python、Go）或者JAR包（Java），上传至FunctionGraph即可运行，无需其它的部署操作。 制作ZIP包的时候，单函数入口文件必须在根目录，保证解压后，直接出现函数执行入口文件，才能正常运行。 对于Go runtime，必须在编译之后打zip包，编译后的动态库文件名称必须与函数执行入口的插件名称保持一致，例如：动态库名称为testplugin.so，则“函数执行入口”命名为testplugin.Handler。 对于Java runtime，由于Java是编译型语言，所以不能在线编辑代码。如果函数没有引入其他第三方件，可以选择上传函数jar包。如果函数中引入其他三方件，则需要制作包含所有依赖三方件和函数jar的zip包，选择上传zip文件。 FunctionGraph函数支持的上传程序包的方式下表。 代码上传方式说明 运行时 在线编辑 上传ZIP文件 上传JAR包 从OBS上传文件 Node.js 支持 支持 不支持 支持 Python 支持 支持 不支持 支持 Java 不支持 支持 支持 支持 GO 不支持 支持 不支持 支持 定制运行时 支持 支持 不支持 支持 注意 上传代码时，如果代码中包含敏感信息（如帐户密码等），请您自行加密，以防止信息泄露。 函数代码上传方式表 代码上传方式说明 操作 在线编辑 用户在编辑函数代码时支持类似工程方式的管理，可以创建文件、文件夹并对其进行编辑。如果用户代码是上传zip包的方式，则前端进行相应解压展示，并支持用户在函数详情页的“代码”页签，进行在线编辑修改。 文件：支持创建文件和文件夹功能。其中包括新建文件，新建文件夹、保存、关闭所有文件功能。 编辑：支持在编码框中，对代码进行撤销、恢复、剪切、复制、粘贴、查找、替换操作。 设置：支持设置编码框中代码字体大小、自动格式化和编码框主题颜色。 上传ZIP文件 1. 在函数详情页的“代码”页签，选择“上传自 > Zip文件”。 2. 单击“添加文件”上传本地代码至平台。上传的zip文件大小限制为50M，如超过50M，请通过OBS上传。 从OBS上传文件 1. 在函数详情页的“代码”页签，选择“上传自 > OBS地址”。 2. 单击“添加文件”上传本地代码至平台。

步骤六：测试函数 1. 在函数详情页，单击“测试”，在弹窗中创建新的测试事件。 2. 选择“空白模板”，事件名称输入“helloworld”，测试事件修改为如下所示，完成后单击“创建”。 { "message": "HelloWorld" } 步骤七：查看执行结果 单击helloworld事件的“测试”，执行后，在右侧查看执行结果，执行结果如下图。 执行结果 “函数返回”显示函数的返回结果。 “日志”部分显示函数执行过程中生成的日志。 “执行摘要”部分显示“日志”中的关键信息。 步骤八：查看监控指标 在函数详情页面，选择“监控”页签。 在“监控”页签，先选择“指标”，再选择时间粒度（5分钟、15分钟、1小时），查看函数运行状态。 可以查看的指标有：调用次数、错误次数、运行时间（包括最大运行时间、最小运行时间、平均运行时间）、被拒绝次数。 步骤九：删除函数 在函数详情页面，单击右上角的“操作 > 删除函数”。 在确认框继续单击“确认”，及时释放资源。

本文介绍边缘函数增值服务的计费规则和注意事项。 重要说明 边缘函数功能可以让企业研发人员将自定义的代码秒级一键部署到天翼云CDN边缘节点上，实现可编程CDN能力，快速满足不同客户的个性化定制需求。 计费规则 边缘函数按函数执行次数计费，标准资费说明如下： 函数规格 标准资费 单位 10ms 1 元/百万次 50ms 3 元/百万次 100ms 5 元/百万次 计费方式：按量后付费。 计费周期：按小时结算，定时扣费。 注意事项 边缘函数功能在中国内地和全球（不含中国内地）计费的标准资费相同。 函数规格指单次运行函数的CPU耗时，该耗时不包括等待IO的时间。

本文将介绍如何为函数配置层,包括官方层和自定义层。 层的类型 函数可以配置以下两种层 官方公共层：提供给所有租户使用的层 自定义层：用户自定义创建的层，供自己使用，一般来说，对其他租户不可见 前提条件 创建函数 创建层 使用限制 单个函数默认最多可以配置5个层。 单个层的大小限制默认为500M，单个函数层的总大小默认为2G。 配置官方层 1. 在函数详情页面，选择配置 层 ，点击编辑，进入层编辑页面。 2. 点击添加层 官方公共层，此时下拉列表将展示和函数运行时匹配的官方公共层。 3. 选择目标公共层，选择目标版本。 4. 如果需要添加多个层，再次点击添加层 进行添加。如果需要移动层的顺序，可以点击上移 、下移进行调整。 5. 最后点击部署。 说明 1. 层兼容的运行时需要和函数的运行时保持一致，否则下拉列表不展示该层。例如：函数使用的是python3.9运行时，层只兼容python3.6，那么这个层不展示。 2. 配置多个层时，后加载的层会覆盖先加载的层。 配置自定义层 1. 在函数详情页面，选择配置 层 ，点击编辑，进入层编辑页面。 2. 点击添加层 自定义层，此时下拉列表将展示和函数运行时匹配的自定义层。 3. 选择目标自定义，选择目标版本。 4. 如果需要添加多个层，再次点击添加层 进行添加。如果需要移动层的顺序，可以点击上移 、下移进行调整。 5. 最后点击部署。 说明 1. 层兼容的运行时需要和函数的运行时保持一致，否则下拉列表不展示该层。例如：函数使用的是python3.9运行时，层只兼容python3.6，那么这个层不展示。 2. 配置多个层时，后加载的层会覆盖先加载的层。

本文主要介绍预留实例管理。 概述 函数工作流提供了按量和预留两种类型的实例。 按量实例是由函数工作流根据用户使用函数的实际情况来创建和释放，当函数工作流收到函数的调用请求时，自动为此请求分配执行环境。 预留实例是将函数实例的创建和释放交由用户管理，当您为某一函数创建了预留实例，函数工作流收到此函数的调用请求时，会优先将请求转发给您的预留实例，当请求的峰值超过预留实例处理能力时，剩余部分的请求将会转发给按量实例，由函数工作流自动为您分配执行环境。 预留实例在创建完成后，会自动加载该函数的代码、依赖包以及执行初始化入口函数，且预留实例会常驻环境，消除冷启动对业务的影响。 注意 不要依赖预留实例本身的初始化函数去执行一次性业务。 预留实例当前支持配置固定数量的预留实例，也支持配置定时伸缩的预留实例和配置智能推荐的预留实例。 配置固定数量的预留实例 直接创建固定个数的预留实例前，确保FunctionGraph控制台已存在需要创建预留实例的目标函数。 1. 登录函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。 2. 选择待配置的函数，单击进入配置详情页。 3. 选择“设置 > 并发”，单击“添加”，开始配置。 图 单击“添加” 4. 参见下表，填写参数。 您可以给函数对应的版本或者别名创建指定数量的预留实例，其中预留实例的数量不能超过并发实例数配额和单函数最大实例数。 表 基础配置说明 参数 说明 函数名称 展示当前配置预留实例的函数的名称。 类型 根据实际业务情况，选择“版本”或“别名”。 选择版本 仅当类型选择“版本”时，需设置此参数。 选择别名 仅当类型选择“别名”时，需设置此参数。 最小实例数 设置最小实例数，输入值不能超过1000。配置最小实例数后，函数工作流会为您创建固定数目的函数实例，并且在您将最小实例数设置为0之前预留实例会持续运行。 闲置模式 开启此参数，表示预留实例在无调用的时候暂停CPU，节省资源，降低费用成本。 说明 别名和对应的版本不可以同时配置预留实例。比如，latest版本对应的别名为1.0，在latest版本下进行了预留实例配置，则在别名1.0下不能再进行预留实例配置，反之同理。 闲置模式开启后，因为在最初阶段会涉及实例的初始化及模式转换，因此该段时间会以预留实例的非闲置模式计费标准进行计费。 5. 配置完成后，单击“确定”，在“预留实例策略配置”列表展示已添加的“策略配置”。 图列表展示

本文介绍边缘函数请求过程中产生的错误码,方便问题排查。 终端用户请求错误 分类 定义 状态码 错误详情 :::: 函数错误 脚本异常：用户函数抛出JavaScript异常 500 Error Code: 1111 Function threw exception 函数错误 禁止访问网络 500 Error Code: 1113 Prohibit access to the intranet 函数错误 超出6个子请求限制 500 Error Code: 1115 Too many subrequests 函数错误 函数没有返回 response 500 Error Code: 1117 Illegal response 资源限制 用户函数超出运行时资源限制： CPU执行时长≤配置的函数规格（10ms/50ms/100ms） 内存≤ 128M 响应时长≤ 30s 500 Error Code: 1201 Exceeded resource limits 内部错误 内部错误 500 Error Code: 1301 Internal Error 函数错误 函数被禁用 500 Error Code: 1407 Function Forbidden

概述 标签用于标识资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。 您可以在函数创建完成后，在配置详情页添加标签，最多可以给同一个函数资源添加20个标签。 应用场景 为函数添加标签，可以方便您快速识别和管理拥有的函数资源。例如，您可以为账户中的函数资源定义一组标签，以跟踪每个函数资源的所有者和用途，使函数管理变得更加轻松。 前提条件 确保已开通标签管理服务（TMS），未开通TMS服务时无法使用TMS预定义标签能力。 添加标签 1. 登录函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。 2. 选择待配置的函数，单击进入函数详情页。 3. 选择“设置 > 标签”，单击“添加标签”。 4. 参考如下命名规则，添加标签键和标签值。 1. 每个标签由一对键值对（KeyValue）组成，且每个标签键（Key）都必须是唯一的，每个标签键（Key）只能有一个值（Value）。 2. 每个函数最多可以添加20个标签。 说明 如您的组织已经设定函数工作流服务的相关标签策略，则需按照标签策略规则为函数添加标签。标签如果不符合标签策略的规则，则可能会导致函数创建失败，请联系组织管理员了解标签策略详情。 参数 规则 标签键 不能为空 不能以sys或空格开头，不能以空格结尾 可用UTF8格式表示的字母（包含中文）、数字和空格，以及以下字符：.: + @ 128个字符以内且不与其他标签键重复 标签值 可以为空字符串 可用UTF8格式表示的字母（包含中文）、数字、空格，以及以下字符： . : / + @ 长度0~255个字符（中文也可以输入255个字符） 5. 添加完成后单击“保存”。保存后的标签键无法修改，标签值可以执行修改操作。

步骤六：测试函数 1. 在函数详情页，单击“测试”，在弹窗中创建新的测试事件。 2. 选择“apigeventtemplate”，事件名称输入“helloworld”，测试事件修改为如下所示，完成后单击“创建”。 { "body": "{"message": "helloworld"}", "requestContext": { "requestId": "11cdcdcf33949dc6d722640a13091c77", "stage": "RELEASE" }, "queryStringParameters": { "responseType": "html" }, "httpMethod": "POST", "pathParameters": {}, "headers": { "ContentType": "application/json" }, "path": "/helloworld", "isBase64Encoded": false } 步骤七：查看执行结果 单击helloworld事件的“测试”，执行后，在右侧查看执行结果，执行结果如下图。 执行结果 “函数返回”显示函数的返回结果。 “日志”部分显示函数执行过程中生成的日志。 “执行摘要”部分显示“日志”中的关键信息。 步骤八：查看监控指标 在函数详情页面，选择“监控”页签。 在“监控”页签，先选择“指标”，再选择时间粒度（5分钟、15分钟、1小时），查看函数运行状态。 可以查看的指标有：调用次数、错误次数、运行时间（包括最大运行时间、最小运行时间、平均运行时间）、被拒绝次数。 步骤九：删除函数 1. 在函数详情页面，单击右上角的“操作 > 删除函数”。 2. 在确认框继续单击“确认”，及时释放资源。

本章介绍函数工作流如何同步调用函数。 同步调用指的是客户端触发函数后，需阻塞等待函数调用结果返回的场景。您也可以使用同步执行函数接口同步触发函数。同步调用场景下，函数最大运行时长限制为15分钟。

本文介绍BosonFaas边缘函数相关使用限制。 规格说明 功能 规格限制 说明 ::: 函数个数 20个 单个用户账号允许发布的函数个数 开发语言 JavaScript（ES6） 运行时支持的开发语言，后续会陆续扩展更多语言 CPU运行时间 支持10ms、50ms、100ms三种规格 指单次请求运行用户函数的CPU耗时，该耗时不包括等待IO的时间 内存 128MB 单次请求运行用户函数的内存占用 响应时间 30s 单次请求运行用户函数的响应时间 子请求 6个 单次请求运行用户函数允许发出fetch子请求的数量 重定向次数 暂不支持重定向 请求URL 64KB 用户函数接收终端用户请求的URL长度，超过则返回494状态码 请求标头 64KB 用户函数接收终端用户单个请求标头大小不大于64KB，超过则返回494状态码；请求标头总大小不大于256KB，超过则返回414状态码 代码限制 以下函数出于安全原因，不允许使用： eval() new Function

配置CTS事件触发函数 1、返回函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。 2、选择待配置的函数，单击进入函数详情页。 3、在HelloWorld函数详情页，选择函数版本，单击“测试”，弹出“配置测试事件”对话框。 4、填写如表所示测试信息后，单击“保存”。 表 测试信息 参数 说明 配置测试事件 可创建新的测试事件也可编辑已有的测试事件。选择“创建新的测试事件”。 事件模板 选择“ctseventtemplate”模板，使用系统内置CTS事件模板。 事件名称 您自定义的事件名称，例如：ctstest。 测试事件 自动加载系统内置CTS事件模板，您可以根据实际情况修改。 5、单击“测试”，可以得到函数运行结果记录。

示例3：特定资源权限配置 特定资源：授予IAM用户特定资源的相应权限。例如授予IAM用户所属应用Default下函数functionname的相应权限，需将函数functionname设置为指定资源路径，添加资源路径：FUNCTIONGRAPH:::function:Default/functionname。 说明 指定函数资源： 【格式】FUNCTIONGRAPH:::function:所属应用/函数名称 对于函数资源，IAM自动生成资源路径前缀“FUNCTIONGRAPH:::function:”。通过所属应用和函数名称指定具体的资源路径，支持通配符。例如：FUNCTIONGRAPH:::function:Default/表示Default应用下的任意函数。 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "functiongraph:function:list" ] }, { "Effect": "Allow", "Action": [ "functiongraph:function:listAlias", "functiongraph:function:listVersion", "functiongraph:function:getConfig", "functiongraph:function:getCode", "functiongraph:function:updateCode", "functiongraph:function:invoke", "functiongraph:function:updateConfig", "functiongraph:function:createVersion", "functiongraph:function:updateAlias", "functiongraph:function:createAlias" ], "Resource": [ "FUNCTIONGRAPH:::function:Default/" ] } ] }

本章介绍函数工作流如何配置网络。 访问公网 函数创建成功后，默认具有公网访问权限，即函数可直接访问公网上的服务。函数访问公网上的服务需要固定公网出口IP的场景（例如被访问服务需要白名单验证），可以通过开启VPC，在VPC内配置NAT网关绑定EIP的方式实现。 访问VPC 函数支持用户创建虚拟私有云（VPC）并访问自己VPC内的资源。VPC开启后，函数不再具有默认的公网访问权限，如果需要访问公网，可通过在VPC内配置NAT网关绑定EIP的方式实现。 相关权限 配置委托权限请参见配置委托权限。 操作步骤 1. 登录函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。 2. 选择待配置的函数，单击进入函数详情页。 3. 选择“设置 > VPC”，开启VPC，配置VPC和子网 配置VPC 4. 配置域名（可选）：如果函数需要通过内网域名访问VPC内的服务，可配置和VPC绑定的域名，域名可以配置多个。 5. 开启IPv6（可选）。 1. 创建虚拟私有云，确保默认子网配置中支持开启IPv6，具体详情请参见《虚拟私有云服务》的“开启/关闭虚拟私有云IPv6”章节。 2. 在步骤3的“VPC”和“子网”中选择已开启IPv6的VPC和子网。 6. 配置完成后单击“保存”。 配置固定公网IP 函数需要在VPC内访问公网或者需要固定公网IP的场景，可以选择给VPC添加NAT网关并绑定EIP的方式。

本章介绍函数工作流如何管理函数日志。 云日志服务（LTS）管理函数日志 FunctionGraph支持开通云日志服务(LTS)，使用更丰富的函数日志管理功能。开通云日志服务后，FunctionGraph会自动创建1个日志组，在这个日志组下会创建20个日志流，函数的日志会随机出现在某个日志流中，比如函数A第一次执行将日志存放在了日志流A中，那么以后都会固定在日志流A中，但是1个日志流中可能包含多个函数的日志。 说明 默认创建的20个日志流，您无法自定义。您可以在函数的“日志”页签下，单击“F12”，找到query接口里的日志流ID，再到lts里找到对应的日志流ID。 若在LTS控制台误删函数日志组，之前的日志数据不可找回，FunctionGraph服务不感知该操作。此时您可以通过修改函数常规设置中的描述信息，保存后触发重建函数日志组。 设置查询条件。 请求列表：支持设置请求ID、调用结果（执行成功、执行失败）、原因分析（初始化失败、加载失败、系统错误、调用超时、内存超限、磁盘超限、代码异常） 请求日志：支持关键字、请求ID、实例ID 调用结果 调用结果 说明 执行成功 函数执行成功打印的日志。 执行失败 函数执行失败打印的日志，包函调用超时、内存超限、磁盘超限、代码异常四种情况。 若想查看调用超时的日志信息，请将“日志类型”切换为调用超时，另外3种执行失败下的日志类型查看方法相同。

配置项 说明 示例值 状态名称 当前节点的名称 invokeFunction 函数 选择调用函数的名称 pytest 版本或别名 选择调用函数的版本或别名 LATEST 函数调用方式 选择调用函数的方式 同步调用 请求负载 输入触发函数的Body信息。支持YAML格式。 { "name": "test" } 下一个状态 选择 HTTP 请求方法，如 GET POST 状态描述 当前节点状态的描述信息 调用一个函数

本章介绍函数工作流如何配置函数异步调用。 异步调用指的是客户端触发函数后，FunctionGraph持久化请求并立即返回，客户端不等待请求最终处理完成，用户无法实时感知请求处理结果。FunctionGraph最终将异步请求排队，在服务端空闲的情况下逐个处理。如果您希望获取异步请求结果通知或者设置异步请求失败重试，请参见配置函数异步。 以下触发器：默认异步调用，用户不可修改。 调用方式 事件源 调用方式 定时器TIMER 异步调用 您也可以使用异步执行函数API接口异步触发函数。异步调用场景下，函数最大运行时长限制为12小时（通过白名单配置）。 说明 如果函数执行端到端时延超过90s，建议使用异步不使用同步，否则会因为网关限制，超过90s后无法收到同步响应。

本文介绍边缘函数产品相关使用限制。 规格限制 功能 规格限制 说明 ::: 函数个数 20个 单个用户账号允许发布的函数个数 开发语言 JavaScript（ES6） 运行时支持的开发语言，后续会陆续扩展更多语言。 代码包大小 5MB 用户函数代码文件大小上限 CPU运行时间 支持10ms、50ms、100ms 指单次请求运行用户函数的CPU耗时，该耗时不包括等待IO的时间 内存 128MB 单次请求运行用户函数的内存占用 响应时间 30s 单次请求运行用户函数的响应时间 子请求 6个 单次请求运行用户函数允许发出fetch子请求的数量 重定向次数 暂不支持重定向 请求URL 64KB 用户函数接收终端用户请求的URL长度，超过则返回494状态码 请求标头 64KB 用户函数接收终端用户单个请求标头大小不大于64KB，超过则返回494状态码 请求标头总大小不大于256KB，超过则返回414状态码 代码限制 以下函数出于安全原因，不允许使用： eval() new Function

兼容性 检查项 作用 状态 解决方案 数据类型或函数 ENCODE()函数 加密 移除 AESENCRYPT()函数代替 DECODE()函数 解密 移除 AESDECRYPT()函数代替 ENCRYPT()函数 加密 移除 SHA2()函数代替 DESENCRYPT()函数 加密 移除 AESENCRYPT()函数代替 DESDECRYPT()函数 解密 移除 AESDECRYPT()函数代替 JSONAPPEND()函数 增加json元素 移除 JSONARRAYAPPEND()函数代替 PASSWORD()函数 修改用户密码 移除 ALTER USER user IDENTIFIED BY 'authstring'; JSONMERGE()函数 将多个json合并为一个 废弃 JSONMERGEPERSERVE()函数代替 SQL MODE NOAUTOCREATEUSER、DB2, MAXDB, MSSQL, MYSQL323, MYSQL40, ORACLE, POSTGRESQL, NOFIELDOPTIONS, NOKEYOPTIONS, NOTABLEOPTIONS 移除 外键约束长度 外键约束名称不能超过64个字符 SELECT TABLESCHEMA, TABLENAME FROM INFORMATIONSCHEMA.TABLES WHERE TABLENAME IN (SELECT LEFT(SUBSTR(ID,INSTR(ID,'/')+1), INSTR(SUBSTR(ID,INSTR(ID,'/')+1),' ibfk ')1) FROM INFORMATIONSCHEMA.INNODBSYSFOREIGN WHERE LENGTH(SUBSTR(ID,INSTR(ID,'/')+1))>64);使用ALTER TABLE调整长度 features GRANT创建用户 移除 CREATE USER GRANT修改用户信息 移除 ALTER USER IDENTIFIED BY PASSWORD 'authstring' 设置密码 移除 IDENTIFIED WITH authplugin AS 'authstring' SQL语句中的N NULL 移除 NULL代替 PROCEDURE ANALYSE()语法 对MySQL字段值进行统计分析后给出建议的字段类型 移除 空间函数 mysqlinstalldb 初始化 移除 mysqld initialize或initializeinsecure

本章介绍函数工作流与其他服务的联系和交互功能。 FunctionGraph服务与以下云服务的对接，实现相关功能，如下表所示。 表 对接服务 服务名称 实现功能 相关内容 API网关（API Gateway） 通过HTTPS调用FunctionGraph函数，使用API Gateway自定义REST API和终端节点来实现。 详细内容参见API网关 对象存储服务（OBS） 构建FunctionGraph函数来处理OBS存储桶事件，例如对象事件或删除事件。当用户将一张照片上传到存储桶时，OBS存储桶调用FunctionGraph函数，实现读取图像和创建照片缩略图。 详细内容参见对象存储服务 云监控服务（CES） FunctionGraph函数实现了与云监控服务对接，函数上报云监控服务的监控指标，用户可以通过云监控服务来查看函数产生的监控指标canjian和告警信息。 详细内容参见云监控服务 虚拟私有云（VPC） 函数支持用户创建虚拟私有云（VPC）并访问自己VPC内的资源，同时支持通过SNAT方式绑定EIP访问外网。 详细内容参见虚拟私有云

运行时文件bootstrap说明 如果程序包中存在一个名为bootstrap的文件，FunctionGraph将执行该文件。如果引导文件未找到或不是可执行文件，函数在调用后将返回错误。 运行时代码负责完成一些初始化任务，它将在一个循环中处理调用事件，直到它被终止。 初始化任务将对函数的每个实例运行一次以准备用于处理调用的环境。 运行时接口说明 FunctionGraph提供了用于自定义运行时的HTTP API来接收来自函数的调用事件，并在FunctionGraph执行环境中发送回响应数据。 获取调用 方法 – Get 路径 – 该接口用来获取下一个事件，响应正文包含事件数据。响应标头包含信息如下。 响应标头信息说明 参数 说明 XCffRequestId 请求ID。 XCFFAccessKey 租户AccessKey，使用该特殊变量需要给函数配置委托。 XCFFAuthToken Token，使用该特殊变量需要给函数配置委托。 XCFFInvokeType 函数执行类型。 XCFFSecretKey 租户SecretKey，使用该特殊变量需要给函数配置委托。 XCFFSecurityToken Security token，使用该特殊变量需要给函数配置委托。 调用响应 方法 – POST 路径 – 该接口将正确的调用响应发送到FunctionGraph。在运行时调用函数处理程序后，将来自函数的响应发布到调用响应路径。 错误上报 方法 – POST 路径 – $REQUESTID为获取事件的响应header中XCffRequestId变量值，说明请参见上表。 $RUNTIMEAPIADDR为系统环境变量，说明请参见下表。 该接口将错误的调用响应发送到FunctionGraph。在运行时调用函数处理程序后，将来自函数的响应发布到调用响应路径。

配置函数依赖 1. 登录FunctionGraph控制台，在左侧导航栏选择“函数 > 函数列表”，进入函数列表界面。 2. 单击函数名称，进入函数详情界面。 3. 在“代码”页签，单击“代码依赖包”所在行的“添加依赖包”，弹出“选择依赖包”对话框。 4. 选择依赖包，单击“确定”。 依赖包配置说明 参数 说明 运行时语言 默认展示当前函数的运行时语言，无法修改。 依赖包源 根据实际业务，选择“公共依赖包”或“私有依赖包”。 依赖包名称 选择当前运行时语言下的依赖包。 版本 选择当前依赖包的具体版本。 说明 一个函数最多可添加20个依赖包。 除了您自行创建的依赖包（私有依赖包）以外，FunctionGraph还提供了一些常见的公共依赖包，您可以直接选择使用。 删除依赖包 依赖包当前无法在界面直接删除，若需删除，请删除依赖包下的所有版本。当所有版本全部删除完成后，依赖包会自动删除。 1. 登录FunctionGraph控制台，在左侧导航栏选择“函数 > 依赖包管理”，进入“依赖包管理”界面。 2. 单击依赖包名称，进入版本历史管理界面。 3. 单击版本号所在行的删除 ， 可以删除该版本，存在多个版本请重复此操作。 删除依赖包版本 如果函数正在使用此依赖包，则无法删除。

环境变量名 含义 获取方式和默认值 RUNTIMEPROJECTID 函数的项目ID Context类提供接口或通过系统环境变量获取 RUNTIMEFUNCNAME 函数名称 Context类提供接口或通过系统环境变量获取 RUNTIMEFUNCVERSION 函数版本 Context类提供接口或通过系统环境变量获取 RUNTIMEHANDLER 函数执行入口 通过系统环境变量获取 RUNTIMETIMEOUT 函数执行的超时时间 通过系统环境变量获取 RUNTIMEUSERDATA 用户通过环境变量传入的值 Context类提供接口或通过系统环境变量获取 RUNTIMECPU 函数占用的CPU资源，取值与MemorySize成比例 Context类提供接口或通过系统环境变量获取 RUNTIMEMEMORY 函数配置的内存大小 Context类提供接口或通过系统环境变量获取单位MB RUNTIMEMAXRESPBODYSIZE 最大返回值限制 通过系统环境变量获取系统默认为6291456 Byte RUNTIMEINITIALIZERHANDLER 函数初始化入口 通过系统环境变量获取 RUNTIMEINITIALIZERTIMEOUT 函数初始化超时时间 通过系统环境变量获取 RUNTIMEROOT Runtime包的路径 通过系统环境变量获取系统默认路径为/home/snuser/runtime RUNTIMECODEROOT 代码在容器中的存放目录 通过系统环境变量获取系统默认路径为/opt/function/code RUNTIMELOGDIR 系统日志在容器中存放的目录 通过系统环境变量获取系统默认路径为/home/snuser/log

本章节以NodeJS和Python语言为例，指导用户如何开发后端解析函数，获取上传的文件。 应用场景 端侧文件上传云主机器是Web和App应用的一类场景，例如服务运行日志的上报，Web应用图片上传等，函数可作为后端，结合APIG提供通用的API处理这类场景。 约束与限制 1. 单次请求上传文件大小不超过6MB。 2. 函数逻辑处理时间不超过15分钟。 操作步骤 1. 创建函数。 1. 登录函数工作流控制台，在左侧导航栏选择“函数 > 函数列表”，单击“创建函数”。 2. 选择“创建空白函数”，填写函数信息，完成后单击“创建函数”。选择运行时：Node.js 14.18。 3. 在“代码”页签，复制如下代码替换默认的函数代码，并单击“部署”更新函数。 const stream require("stream"); const Busboy require("busboy"); exports.handler async (event, context) > { const logger context.getLogger() logger.info("Function start run."); if (!("contenttype" in event.headers) !event.headers["contenttype"].includes("multipart/formdata")) { return { 'statusCode': 200, 'headers': { 'ContentType': 'application/json' }, 'body': 'The request is not in multipart/formdata format.', }; } const busboy Busboy({ headers: event.headers }); let buf Buffer.alloc(0); busboy.on('file', function (fieldname, file, filename, encoding, mimetype) { logger.info('filename:' + JSON.stringify(filename)) file.on('data', function (data) { logger.info('Obtains ' + data.length + ' bytes of data.') buf Buffer.concat([buf, data]); }); file.on('end', function () { logger.info('End data reception'); }); }); busboy.on('finish', function () { //这里处理数据 logger.info(buf.toString()); return { 'statusCode': 200, 'headers': { 'ContentType': 'application/json' }, 'body': 'ok', }; }); //APIG（专享版）触发器默认对数据进行Base64编码，这里解码 const body Buffer.from(event.body, "base64"); var bodyStream new stream.PassThrough(); bodyStream.end(body); bodyStream.pipe(busboy); } 2. 配置函数依赖。 1. 制作依赖包。代码中选择busboy库解析上传的文件，需要生成Node.js14.18版本对应的依赖包busboy.zip。如果您使用Node.js语言其他版本，请制作对应版本的依赖包。 2. 创建依赖包。在左侧导航栏“函数 > 依赖包”管理页面，单击“创建依赖包”，配置完成后单击“确定”。 3. 添加依赖包。进入uploadfile1函数详情页面，在“代码”页签最底部，单击“添加依赖包”。在“私有依赖包”的包源中，选择上一步创建的busboy依赖包，单击“确定”，完成依赖包的添加。 3. 配置APIG（专享版）触发器。 1. 在uploadfile1函数详情页面，单击“设置 > 触发器”，开始创建触发器。 2. 单击“创建触发器”，触发器类型可以选择“API 网关服务(APIG 专享版)”。安全认证：此处为方便测试，配置“None”，实际业务请选择更安全的认证方式，例如IAM认证等。请求协议：选择“HTTPS”。请求方法：在下拉列表中根据需求选择。后端超时（毫秒）：默认5000毫秒。 4. 端到端测试：以curl工具为例（curl F的方式主要用的是linux环境），您也可以选择postman等其他工具，在本地创建app.log文件，内容自定义。执行如下命令测试： curl iv {APIG（专享版）触发器URL} F upload@/{本地文件路径}/app.log

本章会介绍函数工作流的应用场景。 函数工作流应用场景，如实时文件处理、实时数据流处理、Web移动应用后端和人工智能场景。 场景一：事件驱动类应用 以事件驱动的方式执行服务，按需供给，开发者无需关注业务波峰波谷，节省闲时成本，最终降低运维成本。比如文件处理、图片处理、视频直播/转码、实时数据流处理、IoT规则/事件处理等。 实时文件处理 客户端上传文件到OBS，触发FunctionGraph函数，在上传数据后立即进行处理。可以使用FunctionGraph实时创建图像缩略图、转换视频编码、进行数据文件汇聚、筛选等。 其优势有： 灵活扩展，业务爆发时可以自动调度资源运行更多函数实例以满足处理需求。 事件触发，通过上传文件到OBS，触发FunctionGraph函数进行文件处理。 按需收费，只有对函数处理文件数据的时间进行计费，无需购买冗余的资源用于非峰值处理。 实时数据流处理 使用FunctionGraph和DIS处理实时流数据，跟踪应用程序活动、顺序事务处理、分析数据流、整理数据、生成指标、筛选日志、建立索引、分析社交媒体以及遥测和计量IoT设备数据。 其优势有： 事件触发，通过DIS流采集数据，批量数据通过事件触发处理函数进行处理。 灵活扩展，业务爆发时可以自动调度资源运行更多函数实例以满足处理需求。 按需收费，只有对函数处理文件数据的时间进行计费，无需购买冗余的资源用于非峰值处理。

本章介绍函数工作流的产品优势。 无服务器管理 自动运行用户代码，用户无需配置或管理服务器，专注于业务创新。 高弹性 根据请求的并发数量自动调度资源运行函数，实现透明、准确和实时的伸缩，应付业务峰值的访问。 用户无需关心峰值和空闲时段的资源需要申请多少资源，系统根据请求的数量自动扩容/缩容。自动负载均衡将请求分发到函数运行实例。 事件触发 通过事件触发机制，集成多种云服务，满足不同场景需求，获得高效的开发体验。 与云日志服务、云监控服务对接，无需任何配置，即可查询函数日志和监控告警信息，快速排查故障。 高可用 函数运行实例出现异常，系统会启动新的实例处理后续的请求，故障函数实例占用资源将会回收使用。 动态资源指定 函数执行时可根据业务需要动态指定资源规格，最小化资源占用，灵活调度节省成本。

字段 功能含义 规则限制 函数名称 拉下选择要配置预留实例策略的函数 版本或别名 下拉选择要配置预留实例策略的函数版本或别名 版本只可以选择LATEST 预留实例数 预留实例数量 非负整数 不能超过用户能配置的单函数最大实例数限制 闲置模式 闲置模式下的预留实例，在没有请求达到时，不消耗vCPU(在创建预留实例时开启闲置模式则延迟20s暂停vCPU) 可选 定时伸缩 根据定时器规则策略，决定预留实例数 可选 预留实例数 达到定时触发条件时，系统将调整预留实例数到这个值 非负整数 不能超过用户能配置的单函数最大实例数限制 定时表达式 基于cron的定时表达式 时区基准是UTC，请注意时区转换 生效时间 定义此策略生效的时间范围，在此时间范围之外，该策略规则无效 添加配置 点击添加配置可以新增配置

您可以通过本页了解天翼云TeleDB数据库的建立函数语法、[OR REPLACE] 更新函数介绍、[模式名.]函数名介绍。 建立函数语法 plaintext CREATE [OR REPLACE] FUNCTION [模式名.]函数名 ([参数模式 [参数名] 数据类型 [default 默认值] [,…]]) RETRUNS [SETOF] 数据类型 AS [标签] [DECLARE 变量定义] BEGIN 注释 /注释/ 语句执行 END; [标签] LANGUAGE PLPGSQL; [OR REPLACE] 更新函数介绍 OR REPLACE 的作用为函数存在时则替换，建立 PL/pgsql 函数时如果不带 OR REPLACE 关键字， 则遇到函数已经存在，系统会报错，如下所示： plaintext teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb CREATE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; ERROR: function "f" already exists with same argument types teledb CREATE OR REPLACE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb select f(); NOTICE: Hello ,teledb f (1 row) [模式名.]函数名介绍 建立函数名称，模式名可以指定，也可以不指定，不指存则存放在当前模式下，如上面例子就没有指定模式名，则就存放在当前模式下，如下所示： plaintext teledb select from pgnamespace; nspname nspowner nspacl ++ pgtoast 10 pgoracle 10 squeeze 10 pgtemp1 10 pgtoasttemp1 10 pgcatalog 10 {teledbUC/teledb,U/teledb} public 10 {teledbUC/teledb,UC/teledb} informationschema 10 {teledbUC/teledb,U/teledb} (8 rows) teledb

您可以通过本页了解天翼云TeleDB数据库的建立函数语法、[OR REPLACE] 更新函数介绍、[模式名.]函数名介绍。 建立函数语法 plaintext CREATE [OR REPLACE] FUNCTION [模式名.]函数名 ([参数模式 [参数名] 数据类型 [default 默认值] [,…]]) RETRUNS [SETOF] 数据类型 AS [标签] [DECLARE 变量定义] BEGIN 注释 /注释/ 语句执行 END; [标签] LANGUAGE PLPGSQL; [OR REPLACE] 更新函数介绍 OR REPLACE 的作用为函数存在时则替换，建立 PL/pgsql 函数时如果不带 OR REPLACE 关键字， 则遇到函数已经存在，系统会报错，如下所示： plaintext teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb CREATE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; ERROR: function "f" already exists with same argument types teledb CREATE OR REPLACE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb select f(); NOTICE: Hello ,teledb f (1 row) [模式名.]函数名介绍 建立函数名称，模式名可以指定，也可以不指定，不指存则存放在当前模式下，如上面例子就没有指定模式名，则就存放在当前模式下，如下所示： plaintext teledb select from pgnamespace; nspname nspowner nspacl ++ pgtoast 10 pgoracle 10 squeeze 10 pgtemp1 10 pgtoasttemp1 10 pgcatalog 10 {teledbUC/teledb,U/teledb} public 10 {teledbUC/teledb,UC/teledb} informationschema 10 {teledbUC/teledb,U/teledb} (8 rows) teledb

您可以通过本页了解天翼云TeleDB数据库的建立函数语法、[OR REPLACE] 更新函数介绍、[模式名.]函数名介绍。 建立函数语法 CREATE [OR REPLACE] FUNCTION [模式名.]函数名 ([参数模式 [参数名] 数据类型 [default 默认值] [,…]]) RETRUNS [SETOF] 数据类型 AS [标签] [DECLARE 变量定义] BEGIN 注释 /注释/ 语句执行 END; [标签] LANGUAGE PLPGSQL; [OR REPLACE] 更新函数介绍 OR REPLACE 的作用为函数存在时则替换，建立 PL/pgsql 函数时如果不带 OR REPLACE 关键字， 则遇到函数已经存在，系统会报错，如下所示： teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb CREATE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; ERROR: function "f" already exists with same argument types teledb CREATE OR REPLACE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb select f(); NOTICE: Hello ,teledb f (1 row) [模式名.]函数名介绍 建立函数名称，模式名可以指定，也可以不指定，不指存则存放在当前模式下，如上面例子就没有指定模式名，则就存放在当前模式下，如下所示： teledb

配置项 操作说明 示例 触发器类型 选择RocketMQ触发器。 RocketMQ触发器 名称 填写自定义的触发器名称。 rocketmqtrigger 版本或别名 默认值为LATEST，支持选择任意函数版本或函数别名。 LATEST RocketMQ 实例 选择已创建的RocketMQ实例。 Topic 选择已创建的RocketMQ实例的Topic。 Group ID 选择已创建的RocketMQ实例的Group ID。 消费位点 选择消息的消费位点，即触发器从RocketMQ实例开始拉取消息的位置。取值说明如下。 最新位点：从最新位点开始消费。 最早位点：从最早位点开始消费。 指定时间戳：从指定时间戳开始消费。 最新位点 调用方式 选择函数调用方式。 同步调用：指触发器消费topic消息后投递到函数是同步调用，会等待函数响应后继续下一个消息投递。 异步调用：指触发器消费topic消息后投递到函数是异步调用，不会等待函数响应，可以快速消费事件。 同步调用 用户ID RocketMQ实例用户ID，需要在RocketMQ控制台创建。 密钥 RocketMQ实例用户密钥，需要在RocketMQ控制台创建。 触发器启用状态 创建触发器后是否立即启用。默认选择开启，即创建触发器后立即启用触发器。 推送配置 批量推送条数：批量推送的最大值，积压值达到后立刻推送，取值范围为 [1, 10000]。 批量推送间隔：批量推送的最大时间间隔，达到后立刻推送，单位秒，取值[0,15]。默认0无需等待，数据直接推送。 推送格式：函数收到的事件格式，详情请查阅触发器事件消息格式。 重试策略 消息推送函数失败后重试的策略，共两种： 指数退避：指数退避重试，重试5次，重试周期为2，4，8，16，32（秒）。 线性退避：线性退避重试，重试5次，重试周期为1，2，3，4，5（秒）。 容错策略 当重试次数耗尽后仍然失败时的处理方式： 允许容错：当异常发生并超过重试策略配置时直接丢弃。 禁止容错：当异常发生并超过重试策略配置时继续阻塞执行。 死信队列 当容错策略为：允许容错时，可以额外开启死信队列。当开启死信队列时且异常发生并超过重试策略配置时，消息会被投递到指定的消息队列里，当前只支持投递到kafka和rocketmq

本文介绍如何在Node.js运行环境下打印和查看函数日志。 打印日志 当需要查看函数运行相关的自定义状态时，可以使用如下几种方式打印日志至标准输出stdout。往标准输出stdout打印的日志内容会被函数收集。 ES模块 export const handler async (event, context) > { process.stdout.write('hi,fcn'); console.log('hello,world'); context.logger.info('hello,fc'); return "Hello World!"; }; CommonJS模块 'use strict'; exports.handler (event, context, callback) > { process.stdout.write('hi,fcn'); console.log('hello,world'); context.logger.info('hello,fc'); callback(null, 'hello,world'); }; 以下分别介绍所使用的几种日志打印方法。 使用process.stdout.write打印日志 使用此方法打印日志会将内容原样输出到日志中。输出的日志内容如下所示。 hi,fc 使用console.log打印日志 使用此方法打印的每条日志中都会包含时间、RequestId、日志级别等信息。输出的日志内容如下所示。 20240304 07:01:16.927 165e571bc158a59e8b63f98cd471c [info] hello,world 直接使用context.logger打印日志 当您配置的函数实例并发度大于1时，一个函数实例会同时并发处理多个请求。此时强烈建议使用context.logger打印日志，以通过RequestId区分各并发请求的日志。输出的日志内容如下所示。 20240304 07:01:16.927 165e571bc158a59e8b63f98cd471c [[object Object]] hello,fc 查看日志 函数执行完成后，您可以在函数详情页的日志页签查看日志信息。

本章介绍如何管理函数流执行历史记录 执行历史查询 1. 登录FunctionGraph控制台，在左侧导航栏选择“函数流”，进入“函数流”页面。 2. 在“函数流”流程列表页面，单击需要查看执行历史的流程，进入流程详情页面。 3. 切换至“运行记录”页签，查看执行历史运行记录。 4. 左侧为执行历史记录列表，展示最近100次执行记录，支持根据流程执行ID进行查询。 单击左侧的执行记录，中间画布展示流程的执行结果，如果节点执行成功，图标背景为绿色，如果执行失败背景为红色。 执行失败 画布下方输入输出展示区默认展示流程的输入和输出，点击上方任意节点，展示节点的输入和输出。 说明 对于函数流及函数流各个节点，若输出值中有字段的值为null，则该字段会被直接过滤，不予展示。 最下方日志展示流程从开始到结束所有节点的执行记录。 失败流程重试 1. 登录FunctionGraph控制台，在左侧导航栏选择“函数流”，进入“函数流”页面。 2. 在“函数流”流程列表页面，单击需要查看执行历史的流程，进入流程详情页面。 3. 切换至“运行记录”页签，查看执行历史运行记录。 4. 在失败的记录右侧单击重试图标，重试成功后会生成一条执行记录。