接口功能介绍

修改函数

接口约束

无

URI

PUT /openapi/v1/functions/*

路径参数

参数	是否必填	参数类型	说明	示例	下级对象
functionName	是	String	函数名

Query参数

参数	是否必填	参数类型	说明	示例	下级对象
updateType	是	String	更新配置类型，枚举值:基础配置:basic；代码:code；运行时:runtime；层:layer；权限:role；日志:log；网络:network；存储NAS:nas；存储OSS:oss；生命周期:lifecycle；DNS配置:dns；异步配置:asyncConfig；异步成功目标:asyncOk；异步失败目标:asyncFail 健康检查:health	log

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例	下级对象
regionId	是	String	资源池id	test

请求体body参数

参数	是否必填	参数类型	说明	示例	下级对象
container	否	Object	容器配置		Container
lifecycle	否	Object	生命周期配置		Lifecycle
log	否	Object	是否启用日志功能		Log
layers	否	Array of Objects	层配置		Layers
runtime	否	Object	运行时		Runtime
code	否	Object	代码配置		Code
network	否	Object	网络配置		Network
customContainerConfig	否	Object	镜像仓库配置		CustomContainerConfig
createType	否	Integer	创建类型 1：内置运行时 2：自定义运行时 3：自定义镜像	1
ossMount	否	Object	oss配置		OssMount
description	否	String	说明
role	否	String	角色
dns	否	Object	DNS配置		Dns
nas	否	Object	NAS配置		Nas

表 Container

参数	是否必填	参数类型	说明	示例	下级对象
timeZone	是	String	时区	UTC
diskSize	是	Integer	磁盘规格 (Mb)
maxScale	否	Integer	并发实例数上限
minScale	否	Integer	GPU 函数的最小实例数
fastStart	否	Integer	启动加速
healthCheckConfig	否	Object	健康检查		HealthCheckConfig
image	否	String	镜像名
environmentVariables	否	Object	环境变量		EnvironmentVariables
memorySize	是	Integer	内存规格 (Mb)
cpu	是	Double	CPU规格 (vCPU)
runCommand	否	String	运行命令
listenPort	是	Integer	监听端口 （内置运行时传 8080）

表 HealthCheckConfig

参数	是否必填	参数类型	说明	示例	下级对象
failureThreshold	否	Integer	失败阈值
getPath	否	String	检查http get path
initialDelaySeconds	否	Integer	实例初始化后延迟多久开始检查
periodSeconds	否	Integer	检查周期，秒
successThreshold	否	Integer	成功阈值
timeoutSeconds	否	Integer	超时

表 EnvironmentVariables

参数	是否必填	参数类型	说明	示例	下级对象
failureThreshold	否	Integer	失败阈值
getPath	否	String	检查http get path
initialDelaySeconds	否	Integer	实例初始化后延迟多久开始检查
periodSeconds	否	Integer	检查周期，秒
successThreshold	否	Integer	成功阈值
timeoutSeconds	否	Integer	超时

表 Lifecycle

参数	是否必填	参数类型	说明	示例	下级对象
initializer	否	Object	实例初始化		Initializer
preStop	否	Object	实例初始化		PreStop

表 Initializer

参数	是否必填	参数类型	说明	示例	下级对象
handler	否	String	处理方法入口
enable	否	Boolean	启用
timeout	否	Integer	超时

表 PreStop

参数	是否必填	参数类型	说明	示例	下级对象
handler	否	String	处理方法入口
enable	否	Boolean	启用
timeout	否	Integer	超时

表 Log

参数	是否必填	参数类型	说明	示例	下级对象
logEnabled	否	Boolean	是否启用日志功能
logAutoConfig	否	Boolean	是否自动配置
logProjectId	否	String	日志项目id
logProjectCode	否	String	日志项目Code
logUnit	否	String	日志单元名称
logUnitId	否	String	日志单元id
logProject	否	String	日志项目名称
logUnitCode	否	String	日志单元Code
logRuleEnabled	否	Boolean	启用日志分割规则
logRule	否	Object	日志切割配置		LogRule

表 LogRule

参数	是否必填	参数类型	说明	示例	下级对象
ruleCode	否	String	规则唯一编码
ruleName	否	String	规则名称
extractMode	否	Integer	采集类型
collectPolicy	否	String	采集策略
cuttingMode	否	String	切割模式
enable	否	Boolean	是否启用采集规则
unitCode	否	String	日志单元编码
logPaths	否	Array of Strings	待采集的日志文件路径列表		LogPaths
firstLinePattern	否	String	首行正则
customTime	否	Object	自定义时间戳提取格式		CustomTime
ruleConfig	否	Object	容器运行参数		RuleConfig
accessType	否	Integer	接入类型

表 CustomTime

参数	是否必填	参数类型	说明	示例	下级对象
key	否	String	key
timeFormat	否	String	格式化	yyyy-MM-dd HH:mm:ss

表 RuleConfig

参数	是否必填	参数类型	说明	示例	下级对象
maxPathDepth	否	Integer	最大正则路径解析深度
blackPaths	否	Array of Strings	采集路径黑名单		BlackPaths
delimeter	否	Object	分隔符		Delimeter
regex	否	Object	正则切割模式		Regex

表 Delimeter

参数	是否必填	参数类型	说明	示例	下级对象
delimeter	否	String	分隔符
typeContents	否	Array of Objects	类型		TypeContents

表 TypeContents

参数	是否必填	参数类型	说明	示例	下级对象
key	否	String	key
type	否	String	类型

表 Regex

参数	是否必填	参数类型	说明	示例	下级对象
regexStr	否	String	正则表达式
typeContents	否	Array of Objects	类型		TypeContents

表 Layers

参数	是否必填	参数类型	说明	示例	下级对象
layerName	否	String	层名称
version	否	Integer	版本
description	否	String	描述
acl	否	Integer	acl

表 Runtime

参数	是否必填	参数类型	说明	示例	下级对象
runtime	是	String	运行时类型
handleType	否	String	请求处理程序类型（内置运行时必填）	http
executeTimeout	是	Integer	执行超时时间
handler	否	String	函数执行的入口 （内置运行时必填）
instanceConcurrency	是	Integer	实例最大并发度

表 Code

参数	是否必填	参数类型	说明	示例	下级对象
ossBucketName	否	String	oss的bucket
ossObjectName	否	String	oss的name	funcTemplates/python3_event.zip
zipFile	否	String	函数代码 ZIP 包的 Base 64 编码

表 Network

参数	是否必填	参数类型	说明	示例	下级对象
InternetOutAllow	否	Boolean	允许函数访问公网
internetInForbid	否	Boolean	不允许互联网公网访问函数
outVpcId	否	String	networkId
vpcId	否	Integer	vpcId
securityGroupName	否	String	安全组Name
subNetId	否	String	子网ID
subNetName	否	String	子网name
enable	否	Boolean	是否开启VPC
fixedPublicIp	否	Boolean	固定公网ip
outVpcName	否	String	vpcName
securityGroupId	否	String	安全组ID
subNetCidr	否	String	子网CIDR
accessVpcIds	否	Array of Strings	允许VPC访问函数		AccessVpcIds

表 CustomContainerConfig

参数	是否必填	参数类型	说明	示例	下级对象
imageDigest	否	String	digest 用于指定镜像版本
harborUser	否	String	镜像仓库用户名，使用 AES 加密
harborPsw	否	String	镜像仓库密码，使用 AES 加密
gpuEnable	否	Boolean	是否使用Gpu
gpuEciType	否	String	GPU ECI 规格
gpuMemorySize	否	Integer	单位是G
gpuType	否	String	gpu卡型
image	否	String	容器镜像地址。
instanceId	否	String	crs 实例 id

表 OssMount

参数	是否必填	参数类型	说明	示例	下级对象
ak	否	String	AK
sk	否	String	SK
mounts	否	Array of Objects	挂载		Mounts

表 Mounts

参数	是否必填	参数类型	说明	示例	下级对象
bucketName	否	String	bucket名
bucketPath	否	String	bucket子目录
mountDir	否	String	挂载本地目录
readOnly	否	Boolean	是否只读，默认false
accessUrl	否	String	oss 访问地址，默认地址传递空值就行

表 Dns

参数	是否必填	参数类型	说明	示例	下级对象
nameServers	否	Array of Strings	DNS 服务器的 IP 地址列表		NameServers
searches	否	Array of Strings	DNS 搜索域列表		Searches
options	否	Object	DNS 解析配置		Options

表 Nas

参数	是否必填	参数类型	说明	示例	下级对象
remoteDir	否	String	远端挂载目录
sharePath	否	String	挂载地址
localDir	否	String	挂载本地目录
sfsName	否	String	sfs 的名称
sfsUID	否	String	sfs 的 ID

响应参数

参数	参数类型	说明	示例	下级对象
code	Integer	状态码,0表示成功，非0表示不成功	0
requestId	String	请求链路 id	8b2e2212-***
msg	String	补充信息
returnObj	Object	返回实体		Data

表 Data

参数	参数类型	说明	示例	下级对象
functionId	String	函数 id
deployInfo	Object	最近一次编译任务的状态信息		DeployInfo
container	Object	容器配置
lifecycle	Object	生命周期配置
log	Object	是否启用日志功能
layers	Array of Objects	层配置		Layers
runtime	Object	运行时
code	Object	代码配置
network	Object	网络配置
customContainerConfig	Object	镜像仓库
createType	Integer	创建类型 1：内置运行时 2：自定义运行时 3：自定义镜像	1
ossMount	Object	oss配置
description	String	说明

表 DeployInfo

参数	参数类型	说明	示例	下级对象
taskEnd	Integer	结束时间
errMsg	String	错误说明
creator	String	关联的 userId
id	Integer	此次更新内部唯一id
status	String	当前代码部署状态
taskBegin	Integer	开始时间

表 Container

参数	参数类型	说明	示例	下级对象
timeZone	String	时区
diskSize	Integer	磁盘规格
maxScale	Integer	并发实例数上限
minScale	Integer	GPU 函数的最小实例数
fastStart	Integer	启动加速
healthCheckConfig	Object	健康检查		HealthCheckConfig
image	String	镜像名
environmentVariables	Object	环境变量		EnvironmentVariables
memorySize	Integer	内存规格
cpu	Double	CPU规格
runCommand	String	运行命令
listenPort	Integer	监听端口

表 HealthCheckConfig

参数	参数类型	说明	示例	下级对象
failureThreshold	Integer	失败阈值
getPath	String	检查http get path
initialDelaySeconds	Integer	实例初始化后延迟多久开始检查
periodSeconds	Integer	检查周期，秒
successThreshold	Integer	成功阈值
timeoutSeconds	Integer	超时

表 EnvironmentVariables

参数	参数类型	说明	示例	下级对象
failureThreshold	Integer	失败阈值
getPath	String	检查http get path
initialDelaySeconds	Integer	实例初始化后延迟多久开始检查
periodSeconds	Integer	检查周期，秒
successThreshold	Integer	成功阈值
timeoutSeconds	Integer	超时

表 Lifecycle

参数	参数类型	说明	示例	下级对象
initializer	Object	实例初始化		Initializer
preStop	Object	实例初始化		PreStop

表 Initializer

参数	参数类型	说明	示例	下级对象
handler	String	处理方法入口
enable	Boolean	启用
timeout	Integer	超时

表 PreStop

参数	参数类型	说明	示例	下级对象
handler	String	处理方法入口
enable	Boolean	启用
timeout	Integer	超时

表 Log

参数	参数类型	说明	示例	下级对象
logEnabled	Boolean	是否启用日志功能
logAutoConfig	Boolean	是否自动配置
logProjectId	String	日志项目id
logProjectCode	String	日志项目Code
logUnit	String	日志单元名称
logUnitId	String	日志单元id
logProject	String	日志项目名称
logUnitCode	String	日志单元Code
logRuleEnabled	Boolean	启用日志分割规则
logRule	Object	日志切割配置		LogRule

表 LogRule

参数	参数类型	说明	示例	下级对象
ruleCode	String	规则唯一编码
ruleName	String	规则名称
extractMode	Integer	采集类型
collectPolicy	String	采集策略
cuttingMode	String	切割模式
enable	Boolean	是否启用采集规则
unitCode	String	日志单元编码
logPaths	Array of Strings	待采集的日志文件路径列表		LogPaths
firstLinePattern	String	首行正则
customTime	Object	自定义时间戳提取格式		CustomTime
ruleConfig	Object	容器运行参数		RuleConfig
accessType	Integer	接入类型

表 CustomTime

参数	参数类型	说明	示例	下级对象
key	String	key
timeFormat	String	格式化	yyyy-MM-dd HH:mm:ss

表 RuleConfig

参数	参数类型	说明	示例	下级对象
maxPathDepth	Integer	最大正则路径解析深度
blackPaths	Array of Strings	采集路径黑名单		BlackPaths
delimeter	Object	分隔符		Delimeter
regex	Object	正则切割模式		Regex

表 Delimeter

参数	参数类型	说明	示例	下级对象
delimeter	String	分隔符
typeContents	Array of Objects	类型		TypeContents

表 TypeContents

参数	参数类型	说明	示例	下级对象
key	String	key
type	String	类型

表 Regex

参数	参数类型	说明	示例	下级对象
regexStr	String	正则表达式
typeContents	Array of Objects	类型		TypeContents

表 Layers

参数	参数类型	说明	示例	下级对象
layerName	String	层名称
version	Integer	版本
description	String	描述
acl	Integer	acl

表 Runtime

参数	参数类型	说明	示例	下级对象
runtime	String	运行时类型
handleType	String	请求处理程序类型	http
executeTimeout	Integer	执行超时时间
handler	String	函数执行的入口
instanceConcurrency	Integer	实例最大并发度

表 Code

参数	参数类型	说明	示例	下级对象
ossBucketName	String	oss的bucket
ossObjectName	String	oss的name	funcTemplates/python3_event.zip

表 Network

参数	参数类型	说明	示例	下级对象
InternetOutAllow	Boolean	允许函数访问公网
internetInForbid	Boolean	不允许互联网公网访问函数
outVpcId	String	networkId
vpcId	Integer	vpcId
securityGroupName	String	安全组Name
subNetId	String	子网ID
subNetName	String	子网name
enable	Boolean	是否开启VPC
fixedPublicIp	Boolean	固定公网ip
outVpcName	String	vpcName
securityGroupId	String	安全组ID
subNetCidr	String	子网CIDR
accessVpcIds	Array of Strings	允许VPC访问函数		AccessVpcIds

表 CustomContainerConfig

参数	参数类型	说明	示例	下级对象
imageDigest	String	digest 用于指定镜像版本
harborUser	String	镜像仓库用户名，使用 AES 加密
harborPsw	String	镜像仓库密码，使用 AES 加密
gpuEnable	Boolean	是否使用Gpu
gpuEciType	String	GPU ECI 规格
gpuMemorySize	Integer	单位是G
gpuType	String	gpu卡型
image	String	容器镜像地址。
instanceId	String	crs 实例 id

表 OssMount

参数	参数类型	说明	示例	下级对象
ak	String	AK
sk	String	SK
mounts	Array of Objects	挂载		Mounts

表 Mounts

参数	参数类型	说明	示例	下级对象
bucketName	String	bucket名
bucketPath	String	bucket子目录
mountDir	String	挂载本地目录
readOnly	Boolean	是否只读，默认false
accessUrl	String	oss 访问地址，默认地址传递空值就行

表 Dns

参数	参数类型	说明	示例	下级对象
nameServers	Array of Strings	DNS 服务器的 IP 地址列表		NameServers
searches	Array of Strings	DNS 搜索域列表		Searches
options	Object	DNS 解析配置		Options

表 Nas

参数	参数类型	说明	示例	下级对象
remoteDir	String	远端挂载目录
sharePath	String	挂载地址
localDir	String	挂载本地目录
sfsName	String	sfs 的名称
sfsUID	String	sfs 的 ID

枚举参数

无

请求示例

请求url

https://{host}/openapi/v1/functions

请求头header

无

请求体body

{
    "code": {
        "ossBucketName": "",
        "ossObjectName": "funcTemplates/python3/hello-server.py.zip"
    },
    "container": {
        "cpu": 0.5,
        "diskSize": 512,
        "environmentVariables": {},
        "image": "",
        "memorySize": 128,
        "timeZone": ""
    },
    "createType": 1,
    "functionName": "testa01",
    "runtime": {
        "executeTimeout": 64,
        "handleType": "event",
        "handler": "index.handler",
        "instanceConcurrency": 1,
        "runtime": "python3.10"
    }
}

响应示例

{
    "statusCode": 0,
    "message": "",
    "returnObj": {
        "functionId": "5413305594197642",
        "code": {
            "ossBucketName": "",
            "ossObjectName": "funcTemplates/python3_event.zip",
            "snapshotOssObjectName": ""
        },
        "container": {
            "image": "faas-huadong1-grey-registry-huadong1.crs-internal.ctyun.cn/faas/python3.9-runtime:v1.1.2",
            "timeZone": "UTC",
            "memorySize": 128,
            "cpu": 0.1,
            "diskSize": 512,
            "runCommand": "Li9ib290c3RyYXAuc2g=",
            "listenPort": 8080,
            "codeDirPath": "/code",
            "logLevel": "",
            "sysLogLevel": "INFO",
            "maxScale": null,
            "minScale": null,
            "fastStart": 0
        },
        "functionName": "OpenApitest01",
        "ksvcName": "openapitest01-tgswnkzban",
        "description": "",
        "static": null,
        "updateTime": "2024-10-08T16:16:21.578448+08:00",
        "createTime": "2024-10-08T16:16:21.572733+08:00",
        "createType": 1,
        "deployInfo": {
            "creator": "20084",
            "errMsg": "",
            "id": 5413305594263178,
            "status": "applied",
            "taskBegin": 1728375381,
            "taskEnd": 0
        },
        "role": "",
        "log": {
            "logEnabled": false,
            "logAutoConfig": false,
            "logProject": "",
            "logProjectId": "",
            "logProjectCode": "",
            "logUnit": "",
            "logUnitId": "",
            "logUnitCode": "",
            "logHostGroup": "",
            "logRuleEnabled": false
        },
        "network": {
            "accessVpcIds": [],
            "enable": false,
            "fixedPublicIp": false,
            "internetInForbid": false,
            "internetOutAllow": true,
            "outVpcId": "",
            "vpcId": null,
            "outVpcName": "",
            "securityGroupId": "",
            "securityGroupName": "",
            "subNetCidr": "",
            "vcId": "",
            "tunnelIp": "",
            "faasGwId": "",
            "rulePk": 0,
            "subNetId": "",
            "subNetName": ""
        },
        "dns": {
            "nameServers": null,
            "options": null,
            "searches": null
        },
        "lifecycle": {
            "initializer": {
                "handler": "",
                "timeout": 0,
                "enable": false
            },
            "preStop": {
                "handler": "",
                "timeout": 0,
                "enable": false
            }
        },
        "nas": null,
        "ossMount": {
            "ak": "",
            "mounts": null,
            "sk": ""
        },
        "layers": null,
        "runtime": {
            "executeTimeout": 40,
            "handler": "index.handler",
            "instanceConcurrency": 1,
            "runtime": "python3.9",
            "handleType": "event"
        },
        "customContainerConfig": {
            "harborPsw": "",
            "harborUser": "",
            "image": "",
            "imageDigest": "",
            "gpuEnable": false,
            "gpuEciType": "",
            "gpuMemorySize": 0,
            "gpuType": ""
        }
    }
}

状态码

请参考 状态码

错误码

请参考 错误码