有奖捉虫:云通信与企业服务文档专题,速来> HOT

1. 接口描述

接口请求域名: scf.tencentcloudapi.com 。

该接口根据传入参数更新函数配置。

默认接口请求频率限制:100次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:UpdateFunctionConfiguration。
Version String 公共参数,本接口取值:2018-04-16。
Region String 公共参数,详见产品支持的 地域列表
FunctionName String 要修改的函数名称
示例值:
Description String 函数描述。最大支持 1000 个英文字母、数字、空格、逗号和英文句号,支持中文
示例值:
MemorySize Integer 函数运行时内存大小,默认为 128 M,可选范64M、128 M-3072 M,以 128MB 为阶梯。
示例值:128
Timeout Integer 函数最长执行时间,单位为秒,可选值范 1-900 秒,默认为 3 秒
示例值:3
Runtime String 函数运行环境,目前仅支持 Python2.7,Python3.6,Nodejs6.10,Nodejs8.9,Nodejs10.15,Nodejs12.16, PHP5, PHP7,Go1 , Java8和CustomRuntime
示例值:Python3.6
Environment Environment 函数的环境变量
Namespace String 函数所属命名空间
默认值: default
示例值:default
VpcConfig VpcConfig 函数的私有网络配置
Role String 函数绑定的角色
示例值:SCF_ExecuteRole
InstallDependency String 在线依赖安装,TRUE 表示安装,默认值为 FALSE。仅支持 Node.js 函数。
示例值:FALSE
ClsLogsetId String 日志投递到的cls日志集ID
示例值:xxxx
ClsTopicId String 日志投递到的cls Topic ID
示例值:xxxx
Publish String 在更新时是否同步发布新版本,默认为:FALSE,不发布新版本
示例值:FALSE
L5Enable String 是否开启L5访问能力,TRUE 为开启,FALSE为关闭
示例值:FALSE
Layers.N Array of LayerVersionSimple 函数要关联的层版本列表,层的版本会按照在列表中顺序依次覆盖。
DeadLetterConfig DeadLetterConfig 函数关联的死信队列信息
PublicNetConfig PublicNetConfigIn 公网访问配置
CfsConfig CfsConfig 文件系统配置入参,用于云函数绑定CFS文件系统
InitTimeout Integer 函数初始化执行超时时间
示例值:15
ProtocolParams ProtocolParams HTTP函数配置ProtocolType访问协议,当前协议可配置的参数
InstanceConcurrencyConfig InstanceConcurrencyConfig 单实例多并发配置。只支持Web函数。
DnsCache String 是否开启Dns缓存能力。只支持EVENT函数。默认为FALSE,TRUE 为开启,FALSE为关闭
示例值:FALSE
IntranetConfig IntranetConfigIn 内网访问配置
IgnoreSysLog Boolean 忽略系统日志上报

3. 输出参数

参数名称 类型 描述
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 更新函数配置

更新函数配置

输入示例

POST / HTTP/1.1
Host: scf.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: UpdateFunctionConfiguration
<公共请求参数>

{
    "FunctionName": "<FunctionName>",
    "Description": "<Description>"
}

输出示例

{
    "Response": {
        "RequestId": "eac6b301-a322-493a-8e36-83b295459397"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation 操作失败。
FailedOperation.AccountInsufficient 账户余额不足。
FailedOperation.ApmConfigInstanceId 获取Apm InstanceId失败。
FailedOperation.CallNetDeployFailed 调用 NetDeploy 失败。
FailedOperation.ClsServiceUnregistered CLS服务未注册。
FailedOperation.DebugModeUpdateTimeOutFail 调试状态下无法更新执行超时时间。
FailedOperation.InstanceNotFound InstanceNotFound 实例不存在。
FailedOperation.InsufficientBalance 当前账号或命名空间处于欠费状态,请在可用时重试。
FailedOperation.InsufficientResources 本地域资源售罄。
FailedOperation.OpenService 服务开通失败。
FailedOperation.QcsRoleNotFound 角色不存在。
FailedOperation.ReservedInProgress 当前函数已有保留并发设置任务处于进行中,请稍后重试。
FailedOperation.UpdateFunctionConfiguration UpdateFunctionConfiguration操作失败。
InternalError.System 内部系统错误。
InternalError.SystemError 内部服务错误。
InvalidParameter.ParamError 创建函数传参异常。
InvalidParameter.Payload 请求参数不合法。
InvalidParameterValue 参数取值错误。
InvalidParameterValue.Action Action取值与规范不符,请修正后再试。可参考:https://tencentcs.com/5jXKFnBW。
InvalidParameterValue.ApmConfig ApmConfig参数传入错误。
InvalidParameterValue.ApmConfigInstanceId ApmConfigInstanceId参数传入错误。
InvalidParameterValue.ApmConfigRegion ApmConfigRegion参数传入错误。
InvalidParameterValue.CfsParameterDuplicate cfs配置项重复。
InvalidParameterValue.CfsParameterError cfs配置项取值与规范不符。
InvalidParameterValue.Cls Cls传入错误。
InvalidParameterValue.ClsRole 修改Cls配置需要传入Role参数,请修正后重试。
InvalidParameterValue.Description Description传入错误。
InvalidParameterValue.DiskSize DiskSize 参数取值不规范。
InvalidParameterValue.DnsInfo 环境变量DNS[OS_NAMESERVER]配置有误。
InvalidParameterValue.DynamicEnabled DynamicEnabled 参数传入错误。
InvalidParameterValue.EipConfig EipConfig参数错误。
InvalidParameterValue.Environment Environment传入错误。
InvalidParameterValue.EnvironmentExceededLimit 环境变量大小超限,请保持在 4KB 以内。
InvalidParameterValue.EnvironmentSystemProtect 不支持修改函数系统环境变量和运行环境变量。
InvalidParameterValue.FunctionName 函数不存在。
InvalidParameterValue.Handler Handler传入错误。
InvalidParameterValue.IdleTimeOut IdleTimeOut参数传入错误。
InvalidParameterValue.InstanceConcurrencyConfig InstanceConcurrencyConfig 参数传入错误。
InvalidParameterValue.L5Enable L5Enable取值与规范不符,请修正后再试。
InvalidParameterValue.Layers Layers参数传入错误。
InvalidParameterValue.LimitExceeded 参数超出长度限制。
InvalidParameterValue.LogFormat 日志格式不正确。
InvalidParameterValue.MaxConcurrency MaxConcurrency 参数传入错误。
InvalidParameterValue.Memory Memory取值与规范不符,请修正后再试。可参考:https://tencentcs.com/5jXKFnBW。
InvalidParameterValue.MemorySize MemorySize错误。
InvalidParameterValue.Namespace Namespace参数传入错误。
InvalidParameterValue.NodeSpec NodeSpec 参数传入错误。
InvalidParameterValue.NodeType NodeType 参数传入错误。
InvalidParameterValue.PublicNetConfig PublicNetConfig参数错误。
InvalidParameterValue.Runtime Runtime传入错误。
InvalidParameterValue.SystemEnvironment 系统环境变量错误。
InvalidParameterValue.TraceEnable TraceEnable取值与规范不符,请修正后再试。
InvalidParameterValue.Vpc VPC不正确。
InvalidParameterValue.WebSocketsParams WebSocketsParams参数传入错误。
LimitExceeded.Eip eip资源超限。
LimitExceeded.InitTimeout InitTimeout达到限制,可提交工单申请提升限制:https://tencentcs.com/7Fixwt63。
LimitExceeded.IntraIp 内网固定IP个数超限。
LimitExceeded.Memory 内存超出最大限制。
LimitExceeded.PrivilegeContainer 特权容器属性开启失败
LimitExceeded.Timeout Timeout超出最大限制。
ResourceNotFound.CfsMountInsNotMatch 指定的cfs下未找到您所指定的挂载点。
ResourceNotFound.CfsProtocolError CfsProtocolError 参数异常。
ResourceNotFound.CfsStatusError 检测cfs状态为不可用。
ResourceNotFound.CfsVpcNotMatch cfs与云函数所处vpc不一致。
ResourceNotFound.Cmq Cmq不存在。
ResourceNotFound.Function 函数不存在。
ResourceNotFound.FunctionName 函数不存在。
ResourceNotFound.GetCfsMountInsError 获取cfs挂载点信息错误。
ResourceNotFound.GetCfsNotMatch 获取cfs信息错误。
ResourceNotFound.Layer layer不存在。
ResourceNotFound.Namespace Namespace不存在。
ResourceNotFound.Role 角色不存在。
ResourceNotFound.Vpc VPC或子网不存在。
UnauthorizedOperation.CAM CAM鉴权失败。
UnauthorizedOperation.Role 没有权限访问您的Cos资源。
UnsupportedOperation 操作不支持。
UnsupportedOperation.DiskSize DiskSize 配置内测中,需要申请开启。如需使用可联系我们。
UnsupportedOperation.EipFixed 指定的配置EipFixed暂不支持。
UnsupportedOperation.VpcConfig 指定的配置VpcConfig暂不支持。