华为云用户手册

  • 创建委托 创建委托的具体步骤请参见如何创建委托。此处以为FunctionGraph服务授予VPC访问权限为例,介绍如何为FunctionGraph服务创建委托。 登录 统一身份认证 服务( IAM )控制台。 在统一身份认证服务(IAM)的左侧导航窗格中,选择“委托”页签,单击右上方的“创建委托”。 图1 创建委托 如所示,配置委托参数。完成参数配置后单击“完成”,系统弹出“创建成功”提示,单击“立即授权”。 委托名称:serverless-trust。 委托类型:选择“云服务”。 云服务:选择“ 函数工作流 FunctionGraph”。 持续时间:选择“永久”。 描述(可选):填写描述信息。 图2 填写基本信息 进入“选择策略”页面,在右方搜索框中搜索需要添加的权限并勾选,此处以添加VPC Administrator权限为例。选择完成后单击“下一步”。 图3 选择策略 表2 委托权限示例 权限名称 使用描述/场景 VPC Administrator 虚拟私有云服务管理员。 进入“设置最小授权范围”页面,建议根据业务部署的区域选择“指定区域项目资源”,并勾选所需区域。选择完成后单击“确定”,进入“授权成功”界面。 图4 根据业务需要选择对应的权限
  • 应用场景授权项 若您在FunctionGraph服务中使用如表1的场景,请先创建委托。 创建委托时授予的权限类型请您根据实际业务需要进行调整,生产环境中建议您调整为细粒度最小使用权限,保证业务所需权限的同时,也降低权限过大的风险。具体对应授权项参见表1 常见授权项选择进行选择。 表1 常见授权项选择 场景 Admin权限 细粒度最小使用权限 说明 使用 自定义镜像 SWR Administrator 暂不支持 SWR Admin: 容器镜像服务 (SWR)管理员,拥有该服务下的所有权限。 如何创建自定义镜像,请参见使用容器镜像创建函数。 挂载SFS文件系统 SFS Administrator 暂不支持 SFS Administrator:弹性文件服务(SFS)管理员,拥有该服务下的所有权限。 如何挂载SFS文件系统,请参见挂载SFS容量型文件系统。 挂载SFS Turbo文件系统 SFS Turbo ReadOnlyAccess sfsturbo:shares:getShare(查询单个文件系统详细信息) sfsturbo:shares:showFsDir(查询目录是否存在) SFS Turbo ReadOnlyAccess:弹性文件服务SFS Turbo的只读权限。 sfsturbo:shares:getShare:您拥有SFS服务下查询单个文件系统信息的权限。 sfsturbo:shares:showFsDir:您拥有SFS服务下查询目录是否存在的权限。 如何挂载挂载sfs turbo文件系统,请参见挂载SFS Turbo文件系统。 挂载E CS 共享目录 ECS ReadOnlyAccess ecs:cloudServers:get(查询云服务器详情) ECS ReadOnlyAccess:弹性云服务器的只读访问权限。 ecs:cloudServers:get:您拥有ECS服务下查询云服务器信息的权限。 如何挂载ECS共享目录,请参见挂载ECS共享目录。 配置预留实例策略 AOM ReadOnlyAccess aom:metric:get(查询指标) aom:metric:list(查询指标列表) AOM ReadOnlyAccess: 应用运维管理 服务只读权限。 aom:metric:get:您拥有AOM服务下查询某个指标信息的权限。 aom:metric:list:您拥有AOM服务下查询指标列表详情的权限。 使用DIS触发器 DIS Administrator 暂不支持 数据接入服务 (DIS)管理员,拥有该服务下的所有权限。 如何创建DIS触发器,请参见使用DIS触发器。 使用DMS触发器 DMS ReadOnlyAccess dms:instance:get(查看实例详情信息) DMS ReadOnlyAccess:分布式消息服务只读权限。 dms:instance:get:您拥有DMS服务下查看实例详情信息的权限。 配置跨域VPC访问 VPC Administrator vpc:ports:get(查询端口) vpc:ports:create(创建端口) vpc:vpcs:get(查询VPC) vpc:subnets:get(查询子网) vpc:vips:delete(虚IP解绑VM) vpc:securityGroups:get(查询安全组列表或详情) 拥有VPC Administrator权限的用户可以对VPC内所有资源执行任意操作。在函数配置跨VPC访问时,则函数必须配置具备VPC管理权限的委托。 VPC细粒度最小使用权限:您拥有VPC服务下虚IP解绑VM、查询端口、创建端口、查询VPC、查询子网、查询安全组列表或详情的权限。 如何配置跨域VPC访问,请参见配置网络。 DNS 域名 解析 DNS ReadOnlyAccess dns:recordset:get(查询租户Record Set资源) dns:zone:get(查询租户zone) dns:recordset:list(查询Record Set列表) dns:zone:list(查询zone列表) DNS ReadOnlyAccess:云解析服务只读权限,拥有该权限的用户仅能查看云解析服务资源。在函数配置调用DNS服务的接口解析内网域名时,则函数必须具备读取DNS资源权限的委托。 DNS细粒度最小使用权限:您拥有DNS服务下查询租户Record Set资源列表和查询租户zone列表的权限。 如何调用DNS服务的接口解析内网域名,请参见解析DNS内网域名。 开启异步通知 目标服务为OBS时: OBS Administrator obs:bucket:HeadBucket(获取桶元数据) obs:bucket:CreateBucket(创建桶) obs:object:PutObject(PUT上传、POST上传、复制对象、追加写对象、初始化上传段任务、上传段、合并段) OBS Administrator: 对象存储服务 管理员,拥有该服务下的所有权限。 OBS细粒度最小使用权限:您拥有OBS服务下获取桶元数据、创建桶、PUT上传、POST上传、复制对象、追加写对象、初始化上传段任务、上传段、合并段的权限。 如何配置异步通知请参见配置函数的异步调用策略。 目标服务为 SMN 时: SMN Administrator smn:topic:publish(发布消息) smn:topic:list(查询主题列表) SMN Administrator: 消息通知 服务管理员,拥有该服务下的所有权限。 SMN细粒度最小使用权限:您拥有SMN服务下发布消息、查询主题列表的权限。 如何配置异步通知请参见配置函数的异步调用策略。 目标服务为DIS时: DIS Administrator 暂不支持 DIS Administrator:数据接入服务管理员,拥有该服务下的所有权限。 如何配置异步通知请参见配置函数的异步调用策略。
  • 支持引入的依赖库说明 FunctionGraph支持引入标准库及第三方依赖库。 标准库 对于标准库,无论是在线编辑或是本地开发打包上传至FunctionGraph,均可以直接在代码中引入使用。 FunctionGraph内置的非标准库 FunctionGraph内置了部分非标准库,如表1、表2所示。使用方法如同标准库一样,在编写代码时直接引入即可。 表1 Node.js Runtime集成的三方件 名称 功能 版本号 q 异步方法封装 1.5.1 co 异步流程控制 4.6.0 lodash 常用工具方法库 4.17.10 esdk-obs-nodejs OBS sdk 2.1.5 express 极简web开发框架 4.16.4 fgs-express 在FunctionGraph和API Gateway之上使用现有的Node.js应用程序框架运行无服务器应用程序和REST API 。提供的示例允许您使用Express框架轻松构建无服务器Web应用程序/服务和RESTful API 。 1.0.1 request 简化http调用,支持HTTPS并默认遵循重定向。 2.88.0 表2 Python Runtime支持的非标准库 模块 功能 版本号 dateutil 日期/时间处理 2.6.0 requests http库 2.7.0 httplib2 httpclient 0.10.3 numpy 数学计算 pip2.7,numpy==1.16.6 pip3.10,numpy==1.24.2 pip3.9,numpy==1.18.5 pip3.6,numpy==1.18.5 redis redis客户端 2.10.5 obsclient OBS客户端 3.0.3 smnsdk 访问公有云smn服务 1.0.1 其他第三方库 建议在本地将依赖的第三方库打包,上传至OBS桶或直接在函数控制台上传,在“代码”页签下添加相关的依赖包,即可在函数代码中使用。
  • 操作场景 函数依赖包包含支持函数业务代码运行的公共库,您可以将业务代码所需的公共库封装成依赖包进行单独管理,便于多函数共享,同时也能有效缩减函数代码包在部署与更新过程中的体积。 函数工作流控制台的“依赖包管理”模块统一管理所有的依赖包,可以直接上传或通过OBS地址上传依赖包,并为依赖包命名。支持用户针对同一依赖包进行版本的迭代,即同一依赖包可拥有多个版本,便于用户对依赖包进行系统化管理。请参考为函数配置依赖包进行函数依赖包的配置。
  • 公共依赖包 公共依赖包是华为云为您直接提供的依赖包,可以在函数详情页直接添加相关运行时的依赖包,以支持代码实现业务逻辑。公共依赖包在平台内部缓存,有效避免了冷启动加载的延迟,建议优先选用。 相较于私有依赖包,公共依赖包有以下优势: 公共依赖包提供了开箱即用的依赖生态,免去依赖包构建和上传的步骤,直接在函数详情页添加即可使用。无需过多关注如何配置代码运行环境,使您能更专注于代码和业务逻辑的优化。 FunctionGraph将公共依赖缓存在平台内,相较于私有依赖包,代码冷启动时无需额外时间从存储服务获取依赖文件,减少了网络延迟。 私有依赖的文件大小限制为300MB,处理大文件时需拆分并多次上传;而公共依赖包不受300MB的文件限制,简化了添加与删除的操作。
  • 约束与限制 请参考表1查看所使用的运行时是否支持从OBS上传。不同运行时语言的函数执行入口信息,请参见表1中“函数执行入口”参数介绍。 表1 OBS方式上传支持介绍 运行时 从OBS上传文件 说明 Node.js 支持 - Python 支持 用python语言编写代码时,自己创建的依赖包名不能与python标准库同名,否则会提示module加载失败,例如“json”、“lib”、“os”等。 Java 支持 - Go 支持 编译后的动态库文件名称必须与函数执行入口的插件名称保持一致,例如:动态库名称为testplugin.so,则“函数执行入口”命名为testplugin.Handler。 C# 支持 - PHP 支持 - 定制运行时 支持 - Cangjie 支持 - 当使用“OBS地址”方式进行代码上传部署时,请确保创建函数选择的“区域”与创建OBS桶选择的“区域”一致。 程序文件解压后的源代码大小不能超过1.5G,如需部署超大代码请提交工单联系客服处理。 当您部署的代码大于20M时,在线编辑器将不展示代码,但您仍可以测试您的函数。 图1 编辑器不展示代码 更多函数资源的限制,请参见使用限制。
  • 约束与限制 请参考表1查看所使用的运行时支持的直接上传代码文件类型。不同运行时语言的函数执行入口信息,请参见表1中“函数执行入口”参数介绍。 表1 直接上传代码支持的文件类型 运行时 上传zip文件 上传jar文件 说明 Node.js 支持 不支持 - Python 支持 不支持 用python语言编写代码时,自己创建的依赖包名不能与python标准库同名,否则会提示module加载失败,例如“json”、“lib”、“os”等。 Java 支持 支持 部署Java代码包可以是zip文件或独立的jar文件。 上传jar文件 如果函数代码没有引入依赖包,可以直接上传函数代码jar文件。 如果函数代码引入了依赖包,可以先将依赖包上传至OBS桶,在创建函数时设置依赖包,再上传函数代码jar文件。 上传zip文件 如果函数代码引入了依赖包,也可以制作包含所有依赖包和函数代码jar文件的zip代码包文件,选择上传zip文件。具体示例可参见使用IDEA工具创建普通Java项目、使用IDEA工具创建maven项目。 Go 支持 不支持 编译后的动态库文件名称必须与函数执行入口的插件名称保持一致,例如:动态库名称为testplugin.so,则“函数执行入口”命名为testplugin.Handler。 C# 支持 不支持 - PHP 支持 不支持 - 定制运行时 支持 不支持 - Cangjie 支持 不支持 - 上传代码时,如果代码中包含敏感信息(如账户密码等),请您自行加密,以防信息泄露。 选择上传的代码包文件大小限制为40MB以内,如大小超过该限制,请使用从OBS上传函数代码方式上传程序文件。 当部署的代码大于20M时,如图2所示在线编辑器将不展示代码,但仍可以正常测试函数代码。 图1 编辑器不展示代码 更多函数资源的限制,请参见使用限制。
  • 约束与限制 请参考表1查看支持在线编辑代码操作的运行时和相关说明。 表1 支持在线编辑的运行时 运行时 在线编辑 说明 Node.js 支持 - Python 支持 使用Python语言在线编辑代码,需要输出中文时,请在代码编辑器中增加如下代码: # -*- coding:utf-8 -*- import json def handler (event, context): output = 'Hello message: ' + json.dumps(event,ensure_ascii=False) return output Java 不支持 Java是编译型语言,不支持在线编辑代码,仅支持上传代码包方式配置代码。 Go 不支持 Go是编译型语言,不支持在线编辑代码,仅支持上传代码包方式配置代码。 C# 不支持 C#是编译型语言,不支持在线编辑代码,仅支持上传代码包方式配置代码。 PHP 支持 - 定制运行时 支持 - Cangjie 不支持 - 当代码编辑器中部署的代码大于20M时,在线编辑器将不展示代码,如图2所示,但仍可以正常测试函数代码。 图2 编辑器不展示代码 更多函数资源的限制,请参见使用限制。
  • 操作场景 编写函数业务代码是配置函数实现业务需求的第一步,FunctionGraph预装了适用于Node.js、Python、PHP、定制运行时和HTTP函数的开发工具包,如果函数代码仅依赖于开发工具包库,如图1所示,可以使用控制台中“代码”页签下的代码编辑器在线编辑函数代码。编写函数代码前请参考修改函数执行入口了解如何查看和修改函数执行入口。在线编辑代码区域支持工程方式的管理,请参考在线编辑代码区域管理使用。 完成代码编辑后,单击“部署代码”,控制台会将代码及相关的配置信息压缩到FunctionGraph服务可运行的代码包中,无需其他操作。 图1 在线编辑函数代码 如需再次修改代码编辑区中的代码,请修改完成后重新单击“部署代码”,进行代码更新部署。
  • 准备 已经在FunctionGraph控制台创建函数1、函数2和函数3(运行时语言都使用Python 3.9,代码及功能介绍如下所示),如何创建请参见创建空白函数。 函数1功能:函数执行返回result的值为函数调用事件内的input输入值 import json def handler (event, context): input = event.get('input',0) return { "result": input } 函数2功能:函数执行返回result的值为函数调用事件内的input输入值+2的结果值 import json def handler (event, context): input = event.get('input',0) return { "result": input+2 } 函数3功能:函数执行返回result的值为函数调用事件内的input输入值平方的结果值 import json def handler (event, context): input = event.get('input',0) return { "result": input*input } 使用函数流功能前,请先了解创建函数流、启动函数流。
  • 并行模式操作步骤 返回函数流列表页面,单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排。 单击服务节点,在弹出的配置窗口中选择“并行模式”。 图5 服务节点配置 函数节点分别选择已创建的函数3和函数4,函数流的配置如下。函数参数配置说明请参见表3。 图6 函数3配置 图7 函数4配置 表3 函数参数说明 参数 说明 应用 函数所属应用,用户创建函数时可以进行分组,每个函数应用下面可以创建多个函数,在函数创建时可以指定其归属于某个函数应用。 函数 FunctionGraph中对应的函数。 版本 FunctionGraph中函数对应的版本。 调用方式 创建标准函数流时,需要配置此参数。函数流执行函数节点时的调用方式,默认为同步调用。 函数参数 流程中以json格式作为body参数在执行时传入函数。 Key:填写参数 Value:填写参数值 DefaultValue:设置默认值,参数未获取到值时,默认获取默认值 操作:编辑或删除设置的参数 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 结果输出路径 通过JSONPath表达式确定节点的输出数据的路径。 开启容灾函数 开启后,当前节点名称不能与其他函数节点名称重复。 流程中的所有节点参数配置完成后,单击右上角的“保存”,进行参数配置,最后单击“确定”。 表4 配置信息 参数 说明 名称 输入函数流名称。 企业项目 选择企业项目。 日志记录 创建快速函数流,保存时需要选择此参数。 ALL:为所有事件启用日志记录。 ERROR:仅启用错误日志记录。 NONE:关闭日志记录。 合并参数 将上一个节点的输出与下一个节点的输入合并为输入。 支持返回流式数据 创建快速函数流时可配置此参数。开启后,函数流执行支持返回流式数据。可参见流式文件处理。 需函数流中函数节点的代码调用流式数据接口。 描述 输入函数流的简要描述。 保存成功后,单击“启动”,在弹出的启动执行页面,支持定义输入值或者直接启动。此处选择“定义输入值”。(输入定义值必须是JSON格式的内容。) { "test":123 } 图8 启动执行配置 单击“开始执行”,页面右上角提示“启动函数流xxx成功”。 查看标准函数流或快速函数流执行结果请参见查看执行结果。(如果两个函数执行返回的输出值结构一致,会导致函数执行结果被覆盖。)
  • 准备 已经在FunctionGraph控制台创建函数1、函数2、函数3和函数4(运行时语言都使用Python 3.9,代码及功能介绍如下所示),如何创建请参见创建空白函数。 函数1功能:函数执行返回result的值为函数调用事件内的input输入值+2的结果值 import json def handler (event, context): input = event.get('input',0) return { "result": input+2 } 函数2功能:函数执行返回result的值为函数调用事件内的input输入值平方的结果值 import json def handler (event, context): input = event.get('input',0) return { "result": input*input } 函数3和函数4功能:函数执行返回result的值为“success”。 import json def handler (event, context): print(event) return {"result":"success"} 使用函数流功能前,请先了解创建函数流、启动函数流。
  • 串行模式操作步骤 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排。 单击服务节点,在弹出的配置窗口中选择“串行模式”。 图1 服务节点配置 函数节点分别选择已创建的函数1、函数2,函数流的配置如下。函数参数配置说明请参见表1。 图2 函数1配置 图3 函数2配置 表1 函数参数说明 参数 说明 应用 函数所属应用,用户创建函数时可以进行分组,每个函数应用下面可以创建多个函数,在函数创建时可以指定其归属于某个函数应用。 函数 FunctionGraph中对应的函数。 版本 FunctionGraph中函数对应的版本。 调用方式 创建标准函数流时,需要配置此参数。函数流执行函数节点时的调用方式,默认为同步调用。 函数参数 流程中以json格式作为body参数在执行时传入函数。 Key:填写参数 Value:填写参数值 DefaultValue:设置默认值,参数未获取到值时,默认获取默认值 操作:编辑或删除设置的参数 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 结果输出路径 通过JSONPath表达式确定节点的输出数据的路径。 开启容灾函数 开启后,当前节点名称不能与其他函数节点名称重复。 流程中的所有节点参数配置完成后,单击右上角的“保存”,进行参数配置,最后单击“确定”。 表2 配置信息 参数 说明 名称 输入函数流名称。 企业项目 选择企业项目。 日志记录 创建快速函数流,保存时需要选择此参数。 ALL:为所有事件启用日志记录。 ERROR:仅启用错误日志记录。 NONE:关闭日志记录。 合并参数 将上一个节点的输出与下一个节点的输入合并为输入。 支持返回流式数据 创建快速函数流时可配置此参数。开启后,函数流执行支持返回流式数据。可参见流式文件处理。 需函数流中函数节点的代码调用流式数据接口。 描述 输入函数流的简要描述。 保存成功后,单击“启动”,在弹出的启动执行页面,支持定义输入值或者直接启动。此处选择“定义输入值”。(输入定义值必须是JSON格式的内容。) { "input":3 } 图4 启动执行配置 单击“开始执行”,页面右上角提示“启动函数流xxx成功”。 查看标准函数流或快速函数流执行结果请参见查看执行结果。
  • 准备 已经在FunctionGraph控制台创建函数(运行时语言都使用Python 3.9,代码及功能介绍如下所示),如何创建请参见创建空白函数。 函数功能:函数执行返回值为当前日期和时间。 # -*- coding:utf-8 -*- import json from datetime import datetime def handler (event, context): # 获取当前日期和时间 now = datetime.now() # 使用 f-strings 格式化输出 print(f"格式化输出:{now:%Y-%m-%d %H:%M:%S}") return { "statusCode": 200, "isBase64Encoded": False, "body": json.dumps(event), "headers": { "Content-Type": "application/json" } } 使用函数流功能前,请先了解创建函数流、启动函数流。。
  • 操作步骤 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排。 图1 时间等待函数流 单击编辑框中函数节点分别进行编辑,两个函数都选择已创建的函数,配置可参考图2。函数参数说明如表1所示。 图2 函数-打印时间1节点配置 表1 函数参数说明 参数 说明 应用 函数所属应用,用户创建函数时可以进行分组,每个函数应用下面可以创建多个函数,在函数创建时可以指定其归属于某个函数应用。 函数 FunctionGraph中对应的函数。 版本 FunctionGraph中函数对应的版本。 调用方式 创建标准函数流时,需要配置此参数。函数流执行函数节点时的调用方式,默认为同步调用。 函数参数 流程中以json格式作为body参数在执行时传入函数。 Key:填写参数 Value:填写参数值 DefaultValue:设置默认值,参数未获取到值时,默认获取默认值 操作:编辑或删除设置的参数 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 输出过滤表达式 基于当前流程的json输出参数,可以使用JSONPath格式来选择性的过滤出下一流程的输出参数。 开启容灾函数 开启后,当前节点名称不能与其他函数节点名称重复。 配置时间等待节点,修改“延迟时间(秒)”参数。 图3 配置时间等待节点 流程中的所有节点参数配置完成后,单击右上角的“保存”,进行参数配置,最后单击“确定”。 表2 配置信息 参数 说明 名称 输入函数流名称。 企业项目 选择企业项目。 日志记录 创建快速函数流,保存时需要选择此参数。 ALL:为所有事件启用日志记录。 ERROR:仅启用错误日志记录。 NONE:关闭日志记录。 合并参数 将上一个节点的输出与下一个节点的输入合并为输入。 支持返回流式数据 创建快速函数流时可配置此参数。开启后,函数流执行支持返回流式数据。可参见流式文件处理。 需函数流中函数节点的代码调用流式数据接口。 描述 输入函数流的简要描述。 保存成功后,单击“启动”,在弹出的启动执行页面,支持定义输入值或者直接启动。此处选择“直接启动”。 单击“开始执行”,页面右上角提示“启动函数流xxx成功”。 查看标准函数流或快速函数流执行结果请参见查看执行结果。
  • 操作步骤 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排,具体如图1所示。 图1 循环函数流 单击编辑框中循环组件进行编辑。 图2 配置循环组件 单击编辑框中函数节点进行编辑,函数选择已创建的函数。配置函数参数,参数说明如表1所示。(此处“Value”值要与循环组件中“迭代变量名称”保持一致。) 图3 函数节点配置 表1 函数参数说明 参数 说明 应用 函数所属应用,用户创建函数时可以进行分组,每个函数应用下面可以创建多个函数,在函数创建时可以指定其归属于某个函数应用。 函数 FunctionGraph中对应的函数。 版本 FunctionGraph中函数对应的版本。 调用方式 创建标准函数流时,需要配置此参数。函数流执行函数节点时的调用方式,默认为同步调用。 函数参数 流程中以json格式作为body参数在执行时传入函数。 Key:填写参数 Value:填写参数值 DefaultValue:设置默认值,参数未获取到值时,默认获取默认值 操作:编辑或删除设置的参数 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 输出过滤表达式 基于当前流程的json输出参数,可以使用JSONPath格式来选择性的过滤出下一流程的输出参数。 开启容灾函数 开启后,当前节点名称不能与其他函数节点名称重复。 流程中的所有节点参数配置完成后,单击右上角的“保存”,进行参数配置,最后单击“确定”。 表2 配置信息 参数 说明 名称 输入函数流名称。 企业项目 选择企业项目。 日志记录 创建快速函数流,保存时需要选择此参数。 ALL:为所有事件启用日志记录。 ERROR:仅启用错误日志记录。 NONE:关闭日志记录。 合并参数 将上一个节点的输出与下一个节点的输入合并为输入。 支持返回流式数据 创建快速函数流时可配置此参数。开启后,函数流执行支持返回流式数据。可参见流式文件处理。 需函数流中函数节点的代码调用流式数据接口。 描述 输入函数流的简要描述。 保存成功后,单击“启动”,在弹出的启动执行页面,支持定义输入值或者直接启动。此处选择“定义输入值”。(输入定义值必须是JSON格式的内容。) { "inputs":[ 1, 2, 3, 4 ] } 图4 启动执行配置 单击“开始执行”,页面右上角提示“启动函数流xxx成功”。 查看标准函数流或快速函数流执行结果请参见查看执行结果。
  • 准备 已经在FunctionGraph控制台创建函数(运行时语言使用Python 3.9,代码及功能介绍如下所示),如何创建请参见创建空白函数。 函数功能:函数执行返回result的值为函数调用事件内的input输入值+2的结果值。 import json def handler (event, context): input = event.get('input',0) return { "result": input+2 } 使用函数流功能前,请先了解创建函数流、启动函数流。
  • 操作步骤 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排,各节点配置如下。 函数-input:从event取出input输入值,作为函数返回status的输出值; 异常处理:开启重试机制,当函数返回的status为500或404时进行重试,重试间隔1s,最大重试次数8次; 函数-异常记录:当经过8次重试函数返回的status依旧为500或404时,进行异常记录; 函数-正常输出:如果“函数-input”返回的status不为500或404时,执行“函数-正常输出”。 图1 异常处理函数流编排 配置异常处理,重试条件:$.status==500||$.status==404。 图2 配置异常处理 添加重试之后依旧失败的处理逻辑即“函数-异常记录”。函数参数配置说明请参见表1。 图3 配置异常分支 图4 配置异常处理 表1 函数参数说明 参数 说明 应用 函数所属应用,用户创建函数时可以进行分组,每个函数应用下面可以创建多个函数,在函数创建时可以指定其归属于某个函数应用。 函数 FunctionGraph中对应的函数。 版本 FunctionGraph中函数对应的版本。 调用方式 创建标准函数流时,需要配置此参数。函数流执行函数节点时的调用方式,默认为同步调用。 函数参数 流程中以json格式作为body参数在执行时传入函数。 Key:填写参数 Value:填写参数值 DefaultValue:设置默认值,参数未获取到值时,默认获取默认值 操作:编辑或删除设置的参数 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 输出过滤表达式 基于当前流程的json输出参数,可以使用JSONPath格式来选择性的过滤出下一流程的输出参数。 开启容灾函数 开启后,当前节点名称不能与其他函数节点名称重复。 流程中的所有节点参数配置完成后,单击右上角的“保存”,进行参数配置,最后单击“确定”。 表2 配置信息 参数 说明 名称 输入函数流名称。 企业项目 选择企业项目。 日志记录 创建快速函数流,保存时需要选择此参数。 ALL:为所有事件启用日志记录。 ERROR:仅启用错误日志记录。 NONE:关闭日志记录。 合并参数 将上一个节点的输出与下一个节点的输入合并为输入。 支持返回流式数据 创建快速函数流时可配置此参数。开启后,函数流执行支持返回流式数据。可参见流式文件处理。 需函数流中函数节点的代码调用流式数据接口。 描述 输入函数流的简要描述。 保存成功后,单击“启动”,在弹出的启动执行页面,支持定义输入值或者直接启动。此处选择“定义输入值”。(输入定义值必须是JSON格式的内容。) { "input":200 } 图5 启动执行配置 单击“开始执行”,页面右上角提示“启动函数流xxx成功”。 查看标准函数流或快速函数流执行结果请参见查看执行结果。 重新执行步骤7,此时“定义输入值”输入500,单击“开始执行”,异常处理逻辑会进行重试和记录。
  • 创建EG触发器 在函数流编排页面,单击“开始”节点,在右侧弹出的属性页面添加触发器,触发器类型选择“EG触发器”。 图5 EG触发器 填写触发器配置信息。如表4所示,带*参数为必填项。 表4 定时触发器配置信息 配置项 说明 触发器类型 选择“EG触发器”。 提供方 EG事件源提供方,支持华为云和自定义两种方式。 事件通道 当“提供方”选择“自定义”时,配置此参数。事件通道负责接收来自事件源的事件来触发函数流执行。 事件源 事件源是事件的来源,负责将华为云服务、自定义应用等应用程序生产的事件发布到事件网格。 事件类型 当“提供方”选择“华为云”时,配置此参数。可以指定事件类型进行过滤,满足事件类型才会触发函数流执行。 单击“创建”,完成EG触发器创建。
  • 创建APIG触发器(共享版) 首次使用API网关的用户不再支持共享版服务,老用户仍可继续使用共享版服务。即API网关当前已不提供共享版,目前只有存量用户可以使用共享版。 函数流APIG触发器目前仅支持IAM认证方式。 在函数流编排页面,单击“开始”节点,在右侧弹出的属性页面添加触发器,触发器类型选择“APIG触发器(共享版)”。 图2 APIG(共享版)触发器 填写触发器配置信息。如表2所示,带*参数为必填项。 表2 APIG触发器(共享版)信息 字段 填写说明 触发器类型 选择“APIG触发器(共享版)”。 分组 API分组相当于一个API集合,API提供方以API分组为单位,管理分组内的所有API。如何创建详情请参见创建API分组。 发布环境 API可以同时提供给不同的场景调用,如生产、测试或开发。API网关服务提供环境管理,在不同的环境定义不同的API调用路径。选择“RELEASE”,才能调用。 API类型 API类型:公有API和私有API。 公有API:选择此类型时,API支持上架。 私有API:选择此类型时,当该API所在分组上架时,该API不会上架。 路径 接口请求的路径。 格式如:/users/projects 请求方式 接口调用方式:GET、POST、DELETE、PUT、PATCH、HEAD、OPTIONS、ANY 其中ANY表示该API支持任意请求方法。 API路径 APIG触发器(共享版)创建成功后显示调用URL。 单击“创建”,完成APIG触发器(共享版)创建。
  • 创建APIG触发器(专享版) 函数流APIG触发器目前仅支持IAM认证方式。 前提条件:需要预先创建APIG专享版实例,具体请参见购买专享版实例。 在函数流编排页面,单击“开始”节点,在右侧弹出的属性页面添加触发器,触发器类型选择“APIG触发器(专享版)”。 图3 APIG(专享版)触发器 填写触发器配置信息。如表3,带*参数为必填项。 表3 APIG触发器(专享版)信息 字段 填写说明 触发器类型 选择“APIG触发器(专享版)”。 实例 选择已创建的专享版APIG实例,如何创建详情请参见购买实例。 分组 API分组相当于一个API集合,API提供方以API分组为单位,管理分组内的所有API。如何创建详情请参见创建API分组。 发布环境 API可以同时提供给不同的场景调用,如生产、测试或开发。API网关服务提供环境管理,在不同的环境定义不同的API调用路径。选择“RELEASE”,才能调用。 API类型 API类型:公有API和私有API 公有API:选择此类型时,API支持上架。 私有API:选择此类型时,当该API所在分组上架时,该API不会上架。 路径 接口请求的路径。 格式如:/users/projects 请求方式 接口调用方式:GET、POST、DELETE、PUT、PATCH、HEAD、OPTIONS、ANY 其中ANY表示该API支持任意请求方法。 单击“创建”,完成APIG触发器(专享版)创建。
  • 创建定时触发器 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 单击“开始”节点,在右侧弹出的属性页面添加触发器,触发器类型选择“定时触发器”。 图1 定时触发器 填写触发器配置信息。如表1所示,带*参数为必填项。 表1 定时触发器配置信息 配置项 说明 触发器类型 选择“定时触发器”。 触发规则 定时触发器的触发规则,当前只支持Cron表达式。 Cron表达式 用于表示任务调度的表达式,能够表示特定周期进行的特定的时间、日期等。具体请参见Cron表达式规则。 附加信息 附加信息为json格式,输入必须包含input,在input内输入需要的json体。input的内容会作为流程的输入参数。 单击“创建”,完成定时触发器创建。
  • 操作步骤 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排,“并行分支”节点配置如下。 图1 并行分支节点配置 单击编辑框中函数节点分别进行编辑,函数选择已创建的函数1、函数2和函数3。图2所示函数1配置,其他两个函数请参考配置。函数参数配置说明请参见表1。 图2 函数1配置 表1 函数参数说明 参数 说明 应用 函数所属应用,用户创建函数时可以进行分组,每个函数应用下面可以创建多个函数,在函数创建时可以指定其归属于某个函数应用。 函数 FunctionGraph中对应的函数。 版本 FunctionGraph中函数对应的版本。 调用方式 创建标准函数流时,需要配置此参数。函数流执行函数节点时的调用方式,默认为同步调用。 函数参数 流程中以json格式作为body参数在执行时传入函数。 Key:填写参数 Value:填写参数值 DefaultValue:设置默认值,参数未获取到值时,默认获取默认值 操作:编辑或删除设置的参数 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 输出过滤表达式 基于当前流程的json输出参数,可以使用JSONPath格式来选择性的过滤出下一流程的输出参数。 开启容灾函数 开启后,当前节点名称不能与其他函数节点名称重复。 流程中的所有节点参数配置完成后,单击右上角的“保存”,进行参数配置,最后单击“确定”。 表2 配置信息 参数 说明 名称 输入函数流名称。 企业项目 选择企业项目。 日志记录 创建快速函数流,保存时需要选择此参数。 ALL:为所有事件启用日志记录。 ERROR:仅启用错误日志记录。 NONE:关闭日志记录。 合并参数 将上一个节点的输出与下一个节点的输入合并为输入。 支持返回流式数据 创建快速函数流时可配置此参数。开启后,函数流执行支持返回流式数据。可参见流式文件处理。 需函数流中函数节点的代码调用流式数据接口。 描述 输入函数流的简要描述。 保存成功后,单击“启动”,在弹出的启动执行页面,支持定义输入值或者直接启动。此处选择“定义输入值”。(输入定义值必须是JSON格式的内容。) { "input":3 } 图3 启动执行配置 单击“开始执行”,页面右上角提示“启动函数流xxx成功”。 查看标准函数流或快速函数流执行结果请参见查看执行结果。
  • 准备 已经在FunctionGraph控制台创建函数1、函数2和函数3(运行时语言都使用Python 3.9,代码及功能介绍如下所示),如何创建请参见创建空白函数。 函数1功能:函数执行返回result的值为函数调用事件内的input输入值 import json def handler (event, context): input = event.get('input',0) return { "result": input } 函数2功能:函数执行返回result的值为函数调用事件内的input输入值+2的结果值 import json def handler (event, context): input = event.get('input',0) return { "result": input+2 } 函数3功能:函数执行返回result的值为函数调用事件内的input输入值平方的结果值 import json def handler (event, context): input = event.get('input',0) return { "result": input*input } 使用函数流功能前,请先了解创建函数流、启动函数流。
  • 操作步骤 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排,具体如图1所示。 图1 包含子流程的函数流 单击编辑框中函数节点进行编辑,函数选择已创建的函数。函数参数说明如表1所示。 图2 函数节点配置 表1 函数参数说明 参数 说明 应用 函数所属应用,用户创建函数时可以进行分组,每个函数应用下面可以创建多个函数,在函数创建时可以指定其归属于某个函数应用。 函数 FunctionGraph中对应的函数。 版本 FunctionGraph中函数对应的版本。 调用方式 创建标准函数流时,需要配置此参数。函数流执行函数节点时的调用方式,默认为同步调用。 函数参数 流程中以json格式作为body参数在执行时传入函数。 Key:填写参数 Value:填写参数值 DefaultValue:设置默认值,参数未获取到值时,默认获取默认值 操作:编辑或删除设置的参数 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 输出过滤表达式 基于当前流程的json输出参数,可以使用JSONPath格式来选择性的过滤出下一流程的输出参数。 开启容灾函数 开启后,当前节点名称不能与其他函数节点名称重复。 配置子流程-串行节点和子流程-并发节点。其中参数“选择子流程”选择在准备中已经创建好的函数流。 图3 配置子流程-串行节点 图4 配置子流程-并发节点 配置分支类型。 图5 子流程-串行 图6 子流程-并发 图7 函数-输出原值 流程中的所有节点参数配置完成后,单击右上角的“保存”,进行参数配置,最后单击“确定”。 表2 配置信息 参数 说明 名称 输入函数流名称。 企业项目 选择企业项目。 日志记录 创建快速函数流,保存时需要选择此参数。 ALL:为所有事件启用日志记录。 ERROR:仅启用错误日志记录。 NONE:关闭日志记录。 合并参数 将上一个节点的输出与下一个节点的输入合并为输入。 支持返回流式数据 创建快速函数流时可配置此参数。开启后,函数流执行支持返回流式数据。可参见流式文件处理。 需函数流中函数节点的代码调用流式数据接口。 描述 输入函数流的简要描述。 保存成功后,单击“启动”,在弹出的启动执行页面,支持定义输入值或者直接启动。此处选择“定义输入值”。(输入定义值必须是JSON格式的内容。) { "input":3 } 图8 启动执行配置 单击“开始执行”,页面右上角提示“启动函数流xxx成功”。 查看标准函数流或快速函数流执行结果请参见查看执行结果。 重新执行步骤8、步骤9和步骤10,分别验证“定义输入值”是1和2的执行结果。
  • 准备 创建一个输入值先加2再平方的串行模式的函数流,具体配置详情请参见串行模式操作步骤。 创建一个并行输出原值、输入值加2和输入值的平方的并行分支的函数流,具体配置详情请参见配置函数流的并行分支控制器组件。 已经在FunctionGraph控制台创建函数(运行时语言使用Python 3.9,代码及功能介绍如下所示),如何创建请参见创建空白函数。 函数功能:函数执行返回result的值为函数调用事件内的input输入值 import json def handler (event, context): input = event.get('input',0) return { "result": input } 使用函数流功能前,请先了解创建函数流、启动函数流。
  • 准备 已经在FunctionGraph控制台创建函数(运行时语言使用Python 3.9,代码及功能介绍如下所示),如何创建请参见创建空白函数。 函数功能:函数执行返回result的值为函数调用事件内的input输入值 import json def handler (event, context): input = event.get('input',0) return { "result": input } 使用函数流功能前,请先了解创建函数流、启动函数流。
  • 操作步骤 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排。 以图1为例,将开始节点、函数、结束节点拖入编辑框内,并用连接线连接好。 图1 编排函数流 单击编辑框中函数节点进行编辑。配置函数参数,参数说明如表1所示。 图2 函数节点配置 表1 函数参数说明 参数 说明 应用 函数所属应用,用户创建函数时可以进行分组,每个函数应用下面可以创建多个函数,在函数创建时可以指定其归属于某个函数应用。 函数 FunctionGraph中对应的函数。 版本 FunctionGraph中函数对应的版本。 调用方式 创建标准函数流时,需要配置此参数。函数流执行函数节点时的调用方式,默认为同步调用。 函数参数 流程中以json格式作为body参数在执行时传入函数。 Key:填写参数 Value:填写参数值 DefaultValue:设置默认值,参数未获取到值时,默认获取默认值 操作:编辑或删除设置的参数 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 输出过滤表达式 基于当前流程的json输出参数,可以使用JSONPath格式来选择性的过滤出下一流程的输出参数。 开启容灾函数 开启后,当前节点名称不能与其他函数节点名称重复。 流程中的所有节点参数配置完成后,单击右上角的“保存”,进行参数配置,最后单击“确定”。 表2 配置信息 参数 说明 名称 输入函数流名称。 企业项目 选择企业项目。 日志记录 创建快速函数流,保存时需要选择此参数。 ALL:为所有事件启用日志记录。 ERROR:仅启用错误日志记录。 NONE:关闭日志记录。 合并参数 将上一个节点的输出与下一个节点的输入合并为输入。 支持返回流式数据 创建快速函数流时可配置此参数。开启后,函数流执行支持返回流式数据,可参见流式文件处理。 需函数流中函数节点的代码调用流式数据接口。 描述 输入函数流的简要描述。 保存成功后,单击“启动”,在弹出的启动执行页面,支持定义输入值或者直接启动。此处选择“定义输入值”。(输入定义值必须是JSON格式的内容。) { "input":3 } 图3 启动执行配置 单击“开始执行”,页面右上角提示“启动函数流xxx成功”。 查看执行结果。 标准函数流 如果在函数流编辑页面中,先单击左上角函数流名称,再选择“运行记录”页签,即可查看函数流的执行历史和节点日志。 图4 单击函数流名称 图5 选择运行记录页签 如果在函数流列表页面,先单击函数流名称,再选择“运行记录”页签,即可查看函数流的执行历史和节点日志。 快速函数流 如果在函数流编辑页面中,先单击左上角函数流名称,再选择“日志”页签,然后“请求ID”链接,即可查看执行日志结果。 图6 单击函数流名称 图7 单击请求ID 如果在函数流列表页面,先单击函数流名称,再选择“日志”页签,然后单击“请求ID”链接,即可查看执行日志结果。
  • 操作步骤 登录函数工作流控制台,左侧导航栏单击“函数流”。 单击“创建标准函数流”或“创建快速函数流”,进入新建函数流编排页面。 在函数流编排区域,通过拖拽组件进行流程编排。 单击编辑框中的EG节点进行编辑。配置EG参数,参数说明如表1所示。 图1 EG节点配置 表1 EG节点参数说明 参数 说明 事件通道 事件通道负责接收来自事件源的事件。函数流仅支持编排自定义事件通道:您自行创建的事件通道,用于接收自定义事件源产生的事件。 详情请参见事件通道概述。 事件源 事件源是事件的来源,函数流仅支持自定义的应用作为事件源,通过自定义的事件通道发布事件到事件网格。 详情请参见事件源概述。 事件内容格式 参数“事件负载内容”的内容格式。(目前只支持application/json格式。) 事件负载内容 事件内容。 事件发生主题 事件发生的主题或对象,用以标识哪个具体对象发生了当前事件 输入过滤表达式 基于上一个流程的json输出参数,可以使用JSONPath格式来选择性的过滤出当前流程的输入参数。 输出过滤表达式 基于当前流程的json输出参数,可以使用JSONPath格式来选择性的过滤出下一流程的输出参数。
  • 添加ECS共享目录 添加委托 挂载ECS共享目录需要给函数设置委托(至少拥有tenant guest以及VPC administrator权限),如果没有对应权限的委托,需要新创建,详情请参见创建委托。 配置VPC 添加ECS共享目录前,也需要给函数配置ECS对应的VPC,可以到ECS详情页的“基本信息”页签中查看“虚拟私有云”。单击虚拟私有云名称,进入虚拟私有云的详情页,查看子网。 获取到这两个信息后,可以在函数配置中配置对应的VPC。 添加挂载-ECS 需要在界面上输入ECS上的共享目录路径信息和函数访问路径。 图1 填写路径信息
共100000条