1. 接口描述
接口请求域名: tcb.tencentcloudapi.com 。
该接口根据传入参数更新函数配置。
默认接口请求频率限制:20次/秒。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:UpdateFunctionConfiguration。 |
| Version | 是 | String | 公共参数,本接口取值:2018-06-08。 |
| Region | 否 | String | 公共参数,本接口不需要传递此参数。 |
| EnvId | 是 | String | 环境ID 示例值:env-3icjklduoid |
| FunctionName | 否 | String | 要修改的函数名称 示例值:function-name |
| Description | 否 | String | 函数描述。最大支持 1000 个英文字母、数字、空格、逗号和英文句号,支持中文 示例值:my special function |
| MemorySize | 否 | Integer | 函数运行时内存大小,默认为 128 M,可选范围64M、128 M-3072 M,以 128MB 为阶梯。 示例值:128 |
| Timeout | 否 | Integer | 函数最长执行时间,单位为秒,可选值范围 1-900 秒,默认为 3 秒 示例值:3 |
| Environment | 否 | FunctionEnvironment | 函数的环境变量 |
| VpcConfig | 否 | FunctionVpcConfig | 函数的私有网络配置 |
| PublicNetConfig | 否 | FunctionPublicNetConfig | 公网访问配置 |
| Runtime | 否 | String | 函数运行环境,创建时指定,目前不支持修改。 示例值:Python3.6 |
| Role | 否 | String | 函数绑定的角色 示例值:role |
| InstallDependency | 否 | String | 在线依赖安装,TRUE 表示安装,仅支持 Node.js 函数。 默认值:FALSE 示例值:TRUE |
| ClsTopicId | 否 | String | 日志投递到的cls日志集ID 示例值:fsdfs-sfdsdfsd-sdfsdf |
| ClsLogsetId | 否 | String | 日志投递到的cls Topic ID 示例值:fsdfs-sfdsdfsd-sdfsdf |
| Publish | 否 | String | 在更新时是否同步发布新版本 默认值:FALSE 示例值:FALSE |
| L5Enable | 否 | String | 是否开启L5访问能力,TRUE 为开启,FALSE为关闭 示例值:FALSE |
| Layers.N | 否 | Array of FunctionLayer | 函数要关联的层版本列表,层的版本会按照在列表中顺序依次覆盖。 |
| InitTimeout | 否 | Integer | 函数初始化执行超时时间 示例值:15 |
| DnsCache | 否 | String | 是否开启Dns缓存能力。只支持EVENT函数。 默认值:FALSE 示例值:FALSE |
| IgnoreSysLog | 否 | String | 忽略系统日志上报 示例值:FALSE |
| EipConfig.N | 否 | Array of FunctionEipConfigFixed | 固定IP配置 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 更新函数配置
输入示例
POST / HTTP/1.1
Host: tcb.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: UpdateFunctionConfiguration
<公共请求参数>
{
"EnvId": "playground-2g2mc217d35d5e5e",
"FunctionName": "wxpayFunctions",
"Description": "微信支付云模板内置云函数",
"MemorySize": 512,
"Timeout": 20,
"Environment": {
"Variables": [
{
"Key": "",
"Value": ""
}
]
},
"VpcConfig": {
"VpcId": "",
"SubnetId": ""
},
"PublicNetConfig": {
"PublicNetStatus": "ENABLE",
"EipConfig": {
"EipStatus": "DISABLE"
}
}
}
输出示例
{
"Response": {
"RequestId": "uuid"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation | 操作失败。 |
| InvalidParameter | 参数格式或类型错误,如 Uin、EnvId、Domain 缺失或非法。 |