最佳实践

更新函数配置

最近更新时间:2021-09-17 08:12:04

我的收藏

1. 接口描述

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

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

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

注意:本接口支持金融区地域。由于金融区和非金融区是隔离不互通的,因此当公共参数 Region 为金融区地域(例如 ap-shanghai-fsi)时,需要同时指定带金融区地域的域名,最好和 Region 的地域保持一致,例如:scf.ap-shanghai-fsi.tencentcloudapi.com。

推荐使用 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 为阶梯。
Timeout Integer 函数最长执行时间,单位为秒,可选值范 1-900 秒,默认为 3 秒
Runtime String 函数运行环境,目前仅支持 Python2.7,Python3.6,Nodejs6.10,Nodejs8.9,Nodejs10.15,Nodejs12.16, PHP5, PHP7,Go1 , Java8和CustomRuntime
Environment Environment 函数的环境变量
Namespace String 函数所属命名空间
VpcConfig VpcConfig 函数的私有网络配置
Role String 函数绑定的角色
ClsLogsetId String 日志投递到的cls日志集ID
ClsTopicId String 日志投递到的cls Topic ID
Publish String 在更新时是否同步发布新版本,默认为:FALSE,不发布新版本
L5Enable String 是否开启L5访问能力,TRUE 为开启,FALSE为关闭
Layers.N Array of LayerVersionSimple 函数要关联的层版本列表,层的版本会按照在列表中顺序依次覆盖。
DeadLetterConfig DeadLetterConfig 函数关联的死信队列信息
PublicNetConfig PublicNetConfigIn 公网访问配置
CfsConfig CfsConfig 文件系统配置入参,用于云函数绑定CFS文件系统
InitTimeout Integer 函数初始化执行超时时间

3. 输出参数

参数名称 类型 描述
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 更新函数配置

输入示例

https://scf.tencentcloudapi.com/?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.DebugModeUpdateTimeOutFail 调试状态下无法更新执行超时时间。
FailedOperation.ReservedInProgress 当前函数已有保留并发设置任务处于进行中,请稍后重试。
FailedOperation.UpdateFunctionConfiguration UpdateFunctionConfiguration操作失败。
InternalError.System 内部系统错误。
InternalError.SystemError 内部服务错误。
InvalidParameter.Payload 请求参数不合法。
InvalidParameterValue 参数取值错误。
InvalidParameterValue.CfsParameterDuplicate cfs配置项重复。
InvalidParameterValue.CfsParameterError cfs配置项取值与规范不符。
InvalidParameterValue.Cls Cls传入错误。
InvalidParameterValue.ClsRole 修改Cls配置需要传入Role参数,请修正后重试。
InvalidParameterValue.Description Description传入错误。
InvalidParameterValue.EipConfig EipConfig参数错误。
InvalidParameterValue.Environment Environment传入错误。
InvalidParameterValue.EnvironmentExceededLimit 环境变量大小超限,请保持在 4KB 以内。
InvalidParameterValue.EnvironmentSystemProtect 不支持修改函数系统环境变量和运行环境变量。
InvalidParameterValue.FunctionName 函数不存在。
InvalidParameterValue.Handler Handler传入错误。
InvalidParameterValue.IdleTimeOut IdleTimeOut参数传入错误。
InvalidParameterValue.Layers Layers参数传入错误。
InvalidParameterValue.LimitExceeded 参数超出长度限制。
InvalidParameterValue.Memory Memory取值与规范不符,请修正后再试。可参考:https://tencentcs.com/5jXKFnBW。
InvalidParameterValue.MemorySize MemorySize错误。
InvalidParameterValue.Namespace Namespace参数传入错误。
InvalidParameterValue.PublicNetConfig PublicNetConfig参数错误。
InvalidParameterValue.Runtime Runtime传入错误。
InvalidParameterValue.SystemEnvironment 系统环境变量错误。
InvalidParameterValue.TraceEnable TraceEnable取值与规范不符,请修正后再试。
InvalidParameterValue.WebSocketsParams WebSocketsParams参数传入错误。
LimitExceeded.Eip eip资源超限。
LimitExceeded.InitTimeout InitTimeout达到限制,可提交工单申请提升限制:https://tencentcs.com/7Fixwt63。
LimitExceeded.Memory 内存超出最大限制。
LimitExceeded.Timeout Timeout超出最大限制。
ResourceNotFound.CfsVpcNotMatch cfs与云函数所处vpc不一致。
ResourceNotFound.Cmq Cmq不存在。
ResourceNotFound.Function 函数不存在。
ResourceNotFound.FunctionName 函数不存在。
ResourceNotFound.GetCfsNotMatch 获取cfs信息错误。
ResourceNotFound.Layer layer不存在。
ResourceNotFound.Namespace Namespace不存在。
ResourceNotFound.Role 角色不存在。
ResourceNotFound.Vpc VPC或子网不存在。
UnauthorizedOperation.CAM CAM鉴权失败。
UnsupportedOperation 操作不支持。
目录