发布函数版本

project_id

是

String

参数解释:

租户项目 ID，获取方式请参见获取项目ID。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成，且长度为32个字符。

默认取值:

不涉及。

function_urn

是

String

参数解释:

函数的URN，详细解释见FunctionGraph函数模型的描述。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字、下划线、中划线、冒号组成。

默认取值:

不涉及。

X-Auth-Token

是

String

参数解释:

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

Content-Type

是

String

参数解释:

消息体的类型（格式）。

约束限制:

不涉及。

取值范围:

只能为application/json

默认取值:

application/json

digest

否

String

参数解释

md5键值。

约束限制：

不涉及。

取值范围

不涉及。

默认取值：

不涉及。

version

否

String

参数解释

发布版本名称

约束限制：

仅可包含字母、数字、中划线、下划线和点，以字母/数字开头和结尾。

取值范围

长度不超过42个字符。

默认取值：

默认按时间生成版本号，如v20180116-202722。

description

否

String

参数解释

发布版本描述

约束限制：

不涉及。

取值范围

不超过512字符。

默认取值：

不涉及。

func_urn

String

参数解释

函数的URN（Uniform Resource Name），唯一标识函数。

取值范围

不涉及。

func_name

String

参数解释

函数名称。

取值范围

不涉及。

domain_id

String

参数解释

域名id。

取值范围

不涉及。

namespace

String

参数解释

租户的project id。

取值范围

不涉及。

project_name

String

参数解释

租户的project name。

取值范围

不涉及。

package

String

参数解释

函数所属的分组Package，用于用户针对函数的自定义分组。

取值范围

不涉及。

runtime

String

参数解释：

FunctionGraph函数的运行时，即函数执行环境。

取值范围：

• Java8: Java 8

• Java11: Java 11

• Java17: Java 17

• Java21: Java 21

• Python2.7: Python 2.7

• Python3.6: Python 3.6

• Python3.9: Python 3.9

• Python3.10: Python 3.10

• Python3.12: Python 3.12

• Go1.x: Go 1.x

• Node.js6.10: Nodejs 6.10

• Node.js8.10: Nodejs 8.10

• Node.js10.16: Nodejs 10.16

• Node.js12.13: Nodejs 12.13

• Node.js14.18: Nodejs 14.18

• Node.js16.17: Nodejs 16.17

• Node.js18.15: Nodejs 18.15

• Node.js20.15: Nodejs 20.15

• C#(.NET Core 2.1): C# 2.1

• C#(.NET Core 3.1): C# 3.1

• C#(.NET Core 6.0): C# 6.0

• C#(.NET Core 8.0): C# 8.0

• Custom: 定制运行时

• PHP7.3: Php 7.3

• PHP8.3: Php 8.3

• Cangjie1.0：仓颉1.0版本

• Cangjie0.52.3：仓颉0.52.3版本

• http: HTTP函数

• Custom Image: 自定义镜像函数

timeout

Integer

参数解释

函数执行超时时间

取值范围

范围3～259200秒

handler

String

参数解释

函数执行入口

取值范围

规则：xx.xx，必须包含“. ”；自定义镜像函数handler为“-”

举例：对于node.js函数：myfunction.handler，则表示函数的文件名为myfunction.js，执行的入口函数名为handler。长度不超过128个字符。

memory_size

Integer

参数解释:

函数消耗的内存，单位MB。

取值范围：

• 128

• 256

• 512

• 768

• 1024

• 1280

• 1536

• 1792

• 2048

• 2560

• 3072

• 3584

• 4096

cpu

Integer

参数解释

函数占用的cpu资源。

单位为millicore（1 core=1000 millicores）。

取值范围

取值与MemorySize成比例，默认是128M内存占0.1个核（100 millicores）。

code_type

String

参数解释

函数代码类型

取值范围

-inline: UI在线编辑代码。

-zip: 函数代码为zip包。

-obs: 函数代码来源于obs存储。

-jar: 函数代码为jar包，主要针对Java函数。

-Custom-Image-Swr: 函数代码来源与SWR自定义镜像。

code_url

String

参数解释

当CodeType为obs时，该值为函数代码包在OBS上的地址，CodeType为其他值时，该字段为空。

取值范围

不涉及。

code_filename

String

参数解释

函数的文件名，当CodeType为jar/zip时必须提供该字段，inline和obs不需要提供。

取值范围

不涉及。

code_size

Long

参数解释

函数大小，单位：字节。

取值范围

不涉及。

user_data

String

参数解释

用户自定义的name/value信息。 在函数中使用的参数。 举例：如函数要访问某个主机，可以设置自定义参数：Host={host_ip}

取值范围

总长度不超过4KB。

encrypted_user_data

String

参数解释

用户自定义的name/value信息，用于需要加密的配置。

取值范围

json格式的字符串。

digest

String

参数解释

函数代码SHA512 hash值，用于判断函数是否变化。

取值范围

不涉及。

version

String

参数解释

函数版本号，由系统自动生成，规则：vYYYYMMDD-HHMMSS（v+年月日-时分秒）。

取值范围

不涉及。

image_name

String

参数解释

函数版本的内部标识。

取值范围

不涉及。

xrole

String

参数解释

函数配置委托。需要IAM支持，并在IAM界面创建委托，当函数需要访问其他服务时，必须提供该字段。配置后用户可以通过函数执行入口方法中的context参数获取具有委托中权限的token、ak、sk，用于访问其他云服务。如果用户函数不访问任何云服务，则不用提供委托名称。

取值范围

不涉及。

app_xrole

String

参数解释

函数执行委托。可为函数执行单独配置执行委托，这将减小不必要的性能损耗；不单独配置执行委托时，函数执行和函数配置将使用同一委托。

取值范围

不涉及。

description

String

参数解释

函数描述。

取值范围

不涉及。

version_description

String

参数解释

函数版本描述。

取值范围

不涉及。

last_modified

String

参数解释

函数最后一次更新时间。

取值范围

不涉及。

func_vpc

FuncVpc object

函数vpc配置。需同时为函数配置具有vpc权限的委托。

mount_config

MountConfig object

函数挂载配置。

strategy_config

StrategyConfig object

参数解释：

函数策略配置。

status

Integer

参数解释

函数状态

取值范围

-0: 函数启用状态。

-1: 函数禁用状态。

dependencies

Array of Dependency objects

参数解释

函数状态

取值范围

-0: 函数启用状态。

-1: 函数禁用状态。

initializer_handler

String

参数解释

函数依赖代码包列表。

initializer_timeout

Integer

参数解释

函数初始化入口，规则：xx.xx，必须包含“. ”。当配置初始化函数时，此参数必填。

举例：对于node.js函数：myfunction.initializer，则表示函数的文件名为myfunction.js，初始化的入口函数名为initializer。

取值范围

不涉及。

pre_stop_handler

String

参数解释

初始化超时时间，超时函数将被强行停止，范围1～300秒。当配置初始化函数时，此参数必填。

取值范围

不涉及。

pre_stop_timeout

Integer

参数解释

函数预停止函数的入口，规则：xx.xx，必须包含“. ”。

举例：对于node.js函数：myfunction.pre_stop_handler，则表示函数的文件名为myfunction.js，初始化的入口函数名为pre_stop_handler。

取值范围

不涉及。

enterprise_project_id

String

参数解释

初始化超时时间，超时函数将被强行停止

取值范围

范围1～90秒。

long_time

Boolean

参数解释

企业项目ID，在企业用户创建函数时必填。

取值范围

不涉及。

log_group_id

String

参数解释

是否允许进行长时间超时设置。

取值范围

不涉及。

log_stream_id

String

参数解释

自定义日志查询组id

取值范围

不涉及。

type

String

参数解释

自定义日志查询流id

取值范围

不涉及。

enable_dynamic_memory

Boolean

参数解释

函数类型。

取值范围

• v1：废弃版本。

• v2：正式版本。

function_async_config

FunctionAsyncConfig object

参数解释

是否允许动态内存配置

取值范围

不涉及。

参数解释

函数异步配置

domain_id

String

参数解释：

租户账号id。

取值范围：

不涉及。

namespace

String

参数解释：

租户的project id。

取值范围：

不涉及。

vpc_name

String

参数解释：

虚拟私有云名称。

取值范围：

不涉及。

vpc_id

String

参数解释：

虚拟私有云唯一标识。

取值范围：

不涉及。

subnet_name

String

参数解释：

子网名称。

取值范围：

不涉及。

subnet_id

String

参数解释：

子网编号。

取值范围：

不涉及。

cidr

String

参数解释：

子网掩码。

取值范围：

不涉及。

gateway

String

参数解释：

网关。

取值范围：

不涉及。

security_groups

Array of strings

参数解释：

安全组

取值范围：

字符串列表

is_safety

Boolean

参数解释：

是否开启安全访问。开启时，需要您自行配置VPCEP网络但可以提供更安全的VPC连接访问并打通内网域名。注意：开启后无法关闭。

取值范围：

• true：开启

• false：关闭

mount_user

MountUser object

参数解释：

挂载用户信息。

取值范围：

不涉及。

func_mounts

Array of FuncMount objects

参数解释：

函数挂载列表。

取值范围：

不涉及。

user_id

String

参数解释：

用户ID

取值范围：

-1~65534的非0整数

user_group_id

String

参数解释：

用户组ID

取值范围：

-1~65534的非0整数

mount_type

String

参数解释：

挂载类型，func_mounts非空时必选。

取值范围：

• sfs：sfs容量型

• sfsTrubo：弹性文件服务

• ecs：ecs服务器

mount_resource

String

参数解释：

挂载资源ID（对应云服务ID），func_mounts非空时必选。

取值范围：

不涉及。

mount_share_path

String

参数解释：

远端挂载路径（例如192.168.0.12:/data），如果mount_type为ecs，必选。

取值范围：

ecs服务器开放的共享路径

local_mount_path

String

参数解释：

函数访问路径，func_mounts非空时必选。

取值范围：

函数容器中的挂载目录，一般是2层结构

concurrency

Integer

参数解释：

单函数最大实例数，-1代表该函数实例数无限制

取值范围：

• v1版本：0和-1

• v2版本：[-1, 1000]

concurrent_num

Integer

参数解释：

单实例并发数， v2版本支持。

取值范围：

[1, 1000]

id

String

参数解释：

依赖包版本ID。

取值范围：

不涉及。

owner

String

参数解释：

依赖包属主的domainId。

取值范围：

不涉及。

link

String

参数解释：

依赖包在OBS上的链接。

取值范围：

obs链接地址

runtime

String

参数解释：

FunctionGraph函数的运行时，即函数执行环境。

取值范围：

• Java8: Java 8

• Java11: Java 11

• Java17: Java 17

• Java21: Java 21

• Python2.7: Python 2.7

• Python3.6: Python 3.6

• Python3.9: Python 3.9

• Python3.10: Python 3.10

• Python3.12: Python 3.12

• Go1.x: Go 1.x

• Node.js6.10: Nodejs 6.10

• Node.js8.10: Nodejs 8.10

• Node.js10.16: Nodejs 10.16

• Node.js12.13: Nodejs 12.13

• Node.js14.18: Nodejs 14.18

• Node.js16.17: Nodejs 16.17

• Node.js18.15: Nodejs 18.15

• Node.js20.15: Nodejs 20.15

• C#(.NET Core 2.1): C# 2.1

• C#(.NET Core 3.1): C# 3.1

• C#(.NET Core 6.0): C# 6.0

• C#(.NET Core 8.0): C# 8.0

• Custom: 定制运行时

• PHP7.3: Php 7.3

• PHP8.3: Php 8.3

• Cangjie1.0：仓颉1.0版本

• Cangjie0.52.3：仓颉0.52.3版本

• http: HTTP函数

• Custom Image: 自定义镜像函数

etag

String

参数解释：

依赖包的md5值

取值范围：

不涉及。

size

Long

参数解释：

依赖包大小。

取值范围：

不涉及。

name

String

参数解释：

依赖包名称。

取值范围：

不涉及。

description

String

参数解释：

依赖包描述。

取值范围：

不涉及。

file_name

String

参数解释：

依赖包文件名，如果创建方式为zip时必填。

取值范围：

不涉及。

version

Long

参数解释：

依赖包版本编号。

取值范围：

不涉及。

dep_id

String

参数解释：

依赖包ID

取值范围：

不涉及。

last_modified

Integer

参数解释：

函数最后一次更新时间。

取值范围：

不涉及。

max_async_event_age_in_seconds

Integer

参数解释：

消息最大存活时长。

取值范围：

取值范围[60，86400]。单位：秒。

max_async_retry_attempts

Integer

参数解释：

异步调用失败后的最大重试次数，默认值为3。

取值范围：

取值范围[0，8]。

destination_config

FuncAsyncDestinationConfig object

参数解释：

异步调用目标。

取值范围：

不涉及。

created_time

String

参数解释：

异步调用配置的创建时间。

取值范围：

不涉及。

last_modified

String

参数解释：

异步调用配置的最后更改时间。

取值范围：

不涉及。

on_success

FuncDestinationConfig object

参数解释：

当函数执行成功时，函数计算将调用该配置对应的目标。

on_failure

FuncDestinationConfig object

参数解释：

当函数执行失败（系统错误或函数内部错误）时，函数计算将调用该配置对应的目标。

destination

String

参数解释：

目标类型。

取值范围：

• OBS：通知到OBS服务。

• SMN：通知到SMN服务。

• DIS：通知到DIS服务。

• FunctionGraph： 通知到函数服务。

param

String

参数解释：

通知目标服务对应参数,json字符串。

取值范围：

• OBS：包含bucket桶，对象目录前缀prefix，对象默认expires过期时间[0~365]天，0默认不过期。

• SMN：包含smn 主题topic_urn。

• DIS：包含DIS 通道名stream_name。

• FunctionGraph：包含func_urn，函数urn

error_code

String

错误码

error_msg

String

错误信息

error_code

String

错误码

error_msg

String

错误信息

error_code

String

错误码

error_msg

String

错误信息

error_code

String

错误码

error_msg

String

错误信息

error_code

String

错误码

error_msg

String

错误信息

200

OK

400

Bad Request 请求错误。

401

Unauthorized 鉴权失败。

403

Forbidden 没有操作权限。

404

Not Found 找不到资源。

500

Internal Server Error 服务内部错误。