FunctionGraph函数模型

函数模型

FunctionGraph函数模型如下。

{ 
  "functions": [ 
   { 
    "func_urn": "urn:fss:xxxxxxxxx:7aad83af3e8d42e99ac194e8419e2c9b:function:default:test", 
    "func_name": "test", 
    "domain_id": "cff01_hk", 
    "namespace": "7aad83af3e8d42e99ac194e8419e2c9b", 
    "project_name": "xxxxxxxxxx", 
    "package": "default", 
    "runtime": "Node.js6.10", 
    "timeout": 3, 
    "handler": "test.handler", 
    "memory_size": 128, 
    "cpu": 300, 
    "code_type": "inline", 
    "code_url": "", 
    "code_filename": "index.js", 
    "code_size": 272, 
    "user_data": "", 
    "digest": "decbce6939297b0b5ec6d1a23bf9c725870f5e69fc338a89a6a4029264688dc26338f56d08b6535de47f15ad538e22ca66613b9a46f807d50b687bb53fded1c6", 
    "version": "latest", 
    "image_name": "latest-5qe8e", 
    "xrole": "cff",
    "app_xrole": null, 
    "description": "111", 
    "version_description": "", 
    "last_modified": "2018-03-28T11:30:32+08:00",
"func_code": {
  "file": "",
  "link": ""
 },
 "func_vpc":null,
 "mount_config":null,
 "depend_list": null,
 "strategy_config": {
     "concurrency": -1
 },
 "extend_config": "",
 "dependencies": null,
"initializer_handler": "index.initializer",
"initializer_timeout": 3  
   } 
  ], 
  "next_marker": 45 
 }

字段说明

FunctionGraph函数字段说明如表1所示。

表1 FunctionGraph函数字段说明
名称	说明
func_urn	函数的URN（Uniform Resource Name），唯一标识函数。
func_name	函数名称。
domain_id	租户名称。
namespace	租户的Project ID。
project_name	租户的Project Name。
package	函数所属的分组Package，用于用户针对函数的自定义分组。
runtime	FunctionGraph函数的执行环境，支持Node.js 6.10、Node.js 8.10、Node.js 10.16、Node.js 12.13、Python 2.7、Python 3.6、Java 8、Go 1.8、C#.NET Core 2.0、C#.NET Core 2.1、C#.NET Core 3.1和PHP 7.3。
timeout	函数执行超时时间，超时函数将被强行停止，范围3～900秒。
handler	函数执行入口，规则：xx.xx，必须包含“. ”。举例：对于Node.js函数：myfunction.handler，则表示函数的文件名为myfunction.js，执行的入口函数名为handler。
memory_size	函数消耗的内存，单位M。取值范围为：128、256、512、768、1024、1280、1536、1792、2048、2560、3072、3584、4096。最小值为128，最大值为4096。
cpu	函数占用的CPU资源，单位为millicore（1 core=1000 millicores）。取值与MemorySize成比例，默认是128M内存占0.1个核（100 millicores），函数占用的CPU为基础CPU：200 millicores，再加上内存按比例占用的CPU，计算方法：内存/128 * 100 + 200。
code_type	函数代码类型，取值有4种： inline：UI在线编辑代码。 zip：函数代码为zip包。 jar：函数代码为jar包，主要针对Java函数。 obs：函数代码来源于OBS存储。
code_url	当“code_type”为“obs”时，该值为函数代码包在OBS上的地址。当“code_type”为“inline”、“zip”或“jar”时，该字段为空。
code_filename	函数的文件名。当“code_type”为“zip”或“jar”时，必须提供该字段。当“code_type”为“obs”或“inline”，不需要提供该字段。
code_size	函数大小，单位：字节。
user_data	用户自定义的name/value信息，在函数中使用的参数。举例：如函数要访问某个主机，可以设置自定义参数：Host={host_ip}，最多定义20个，总长度不超过4KB。
digest	函数代码SHA512 hash值，用于判断函数是否变化。
version	函数版本号，由系统自动生成，规则：vYYYYMMDD-HHMMSS（v+年月日-时分秒）。
image_name	函数版本的内部标识。
xrole	函数使用的权限委托名称，需要IAM支持，并在IAM界面创建委托，当函数需要访问其他服务时，必须提供该字段。
app_xrole	函数app使用的权限委托名称，需要IAM支持，并在IAM界面创建委托，当函数需要访问其他服务时，必须提供该字段。
description	函数描述。
version_description	函数版本描述。
last_modified	函数最后一次更新时间。
func_code	函数代码，请参考表2。
depend_list	依赖包列表。
strategy_config	函数策略配置，请参考表3。
extend_config	函数扩展配置。
dependencies	依赖代码包列表，请参考表5。
initializer_handler	函数初始化入口，规则：xx.xx，必须包含“. ”。举例：对于Node.js函数：myfunction.initializer，则表示函数的文件名为myfunction.js，初始化的入口函数名为initializer。
initializer_timeout	初始化超时时间，超时函数将被强行停止，范围1 ～ 300秒。
func_vpc	vpc配置，请参考表4。
mount_config	文件系统配置，请参考表6。

表2 func_code参数说明
参数	说明
file	函数代码内容，接口返回空。
link	函数代码链接，接口返回空。

表3 strategy_config参数说明
参数	说明
concurrency	0：函数被禁用。 -1：函数被启用。

表4 func_vpc参数说明
参数	类型	是否必选	说明
vpc_name	String	-	虚拟私有云名称
vpc_id	String	当func_vpc非空时必选	虚拟私有云唯一标识
subnet_name	String	-	子网名称
subnet_id	String	当func_vpc非空时必选	子网编号
cidr	String	-	子网掩码
gateway	String	-	网关

表5 dependency参数说明
参数	类型	是否必选	说明
owner	String	-	依赖包属主的domainId
link	String	-	依赖包在OBS上的链接
runtime	String	-	依赖包语言类型（仅作为分类条件）
etag	String	-	依赖包md5值
size	Int	-	依赖包大小
name	String	-	依赖包名称
description	String	-	依赖包描述
file_name	String	-	依赖包文件名（如果创建方式为zip时）

表6 mount_config参数说明
参数	类型	是否必选	说明
mount_user	mount_user	-	文件系统用户配置
func_mounts	func_mounts	-	文件系统列表

表7 mount_user参数说明
参数	类型	是否必选	说明
user_id	Int	mount_user非空时必选	用户ID，-1 ~ +65534的整数(0、1000、1002除外)
user_group_id	Int	mount_user非空时必选	用户组ID，-1 ~ +65534的整数(0、1000、1002除外)

表8 func_mounts参数说明
参数	类型	是否必选	说明
mount_type	String	func_mounts非空时必选	挂载类型(ecs)
mount_resource	String	func_mounts非空时必选	挂载资源ID（对应云服务ID）
mount_share_path	String	“mount_type”为“ecs”时，必选	远端挂载路径（例如192.168.0.12:/data）
local_mount_path	String	func_mounts非空时必选	函数访问路径

funcurn格式如下。

urn:fss:<region_id>:<project_id>:function:<package>:<function_name>[:<version>|:!<alias>]

Funcurn使用冒号分隔为8个域，region_id为系统配置的值（测试时可以填成与后台相同的值），最后一个中括号的内容表示可以为函数的版本号，也可以为该版本指向的别名，如果为别名时需要在名称前加上感叹号！以示区分。

当作为API参数时，可以提供简化格式的Funcurn，具体如下。

提供1个域：解析为<function_name>，“project_id”从token中获取，“package”为“default”，“version”为“latest”。
提供2个域：解析为<package>:<function_name>，“project_id”从token中获取，“version”为“latest”。
提供3个域：解析为<project_id>:<package>:<function_name>，“version”为“latest”。
提供4个域：解析为<project_id>:<package>:<function_name>:<Version or Alias>。
提供7个域：解析为urn:fss:<region_id>:<project_id>:function:<package>:<function_name>，“version”为“latest”。
提供8个域：解析为urn:fss:<region_id>:<project_id>:function:<package>:<function_name>:<Version or Alias>。

父主题： 函数模型定义

上一篇：函数模型定义

下一篇：函数Trigger Management触发器模型

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消