UpdateFunctionConfiguration

Last updated: 2021-09-10 17:17:11

1. API Description

Domain name for API request: scf.tencentcloudapi.com.

This API is used to update the function configuration based on the input parameters.

A maximum of 20 requests can be initiated per second for this API.

Note: This API supports Finance regions. If the common parameter Region is a Finance region, a domain name with the Finance region needs to be specified, for example: scf.ap-shanghai-fsi.tencentcloudapi.com

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common parameter. The value used for this API: UpdateFunctionConfiguration.
Version Yes String Common parameter. The value used for this API: 2018-04-16.
Region Yes String Common parameter. For more information, please see the list of regions supported by the product.
FunctionName Yes String Name of the function to be modified
Description No String Function description. It can contain up to 1,000 characters, including letters, digits, spaces, commas (,), periods (.), and Chinese characters.
MemorySize No Integer Memory size available for function during execution. Default value: 128 MB. Value range: 64 or 128-3,072 MB in increments of 128 MB.
Timeout No Integer Maximum execution duration of function in seconds. Value range: 1-900 seconds. Default value: 3 seconds
Runtime No String Function runtime environment. Valid values: Python2.7, Python3.6, Nodejs6.10, Nodejs8.9, Nodejs10.15, Nodejs12.16, PHP5, PHP7, Go1, Java8, CustomRuntime
Environment No Environment Function environment variable
Namespace No String Function namespace
VpcConfig No VpcConfig Function VPC configuration
Role No String Role bound to the function
ClsLogsetId No String CLS logset ID to which logs are shipped
ClsTopicId No String CLS Topic ID to which logs are shipped
Publish No String It specifies whether to synchronously publish a new version during the update. The default value is FALSE, indicating not to publish a new version
L5Enable No String Whether to enable L5 access. TRUE: enable; FALSE: not enable
Layers.N No Array of LayerVersionSimple List of layer versions that bound with the function. Files with the same name will be overridden by the bound layer versions according to the ascending order in the list.
DeadLetterConfig No DeadLetterConfig Information of a dead letter queue associated with a function
PublicNetConfig No PublicNetConfigIn Public network access configuration
CfsConfig No CfsConfig File system configuration input parameter, which is used for the function to bind the CFS file system
InitTimeout No Integer Timeout period for function initialization. Default value: 15 seconds

3. Output Parameters

Parameter Name Type Description
RequestId String The unique request ID, which is returned for each request. RequestId is required for locating a problem.

4. Example

Example1 Updating function configuration

Input Example

https://scf.tencentcloudapi.com/?Action=UpdateFunctionConfiguration
&FunctionName=<FunctionName>
&Description=<Description>
&<Common request parameters>

Output Example

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

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
FailedOperation Operation failed.
FailedOperation.DebugModeUpdateTimeOutFail Execution timeout period cannot be updated in debug mode.
FailedOperation.ReservedInProgress The function already has a reserved concurrency setting task in progress. Please try again later.
FailedOperation.UpdateFunctionConfiguration The UpdateFunctionConfiguration operation failed.
InternalError.System Internal system error.
InternalError.SystemError Internal service error.
InvalidParameter.Payload Invalid request parameter.
InvalidParameterValue Incorrect parameter value.
InvalidParameterValue.CfsParameterDuplicate The cfs configuration item already exists.
InvalidParameterValue.CfsParameterError The value of cfs configuration item does not meet the specification.
InvalidParameterValue.Cls Cls error.
InvalidParameterValue.ClsRole To modify CLS configuration, Role parameter is required. Please check and try again.
InvalidParameterValue.Description Description error.
InvalidParameterValue.EipConfig EipConfig parameter error.
InvalidParameterValue.Environment Environment error.
InvalidParameterValue.EnvironmentExceededLimit The size of the environment variable exceeds the limit. Please keep it within 4 KB.
InvalidParameterValue.EnvironmentSystemProtect You cannot modify the function's system environment variables or runtime environment variables.
InvalidParameterValue.FunctionName The function does not exist.
InvalidParameterValue.Handler Handler error.
InvalidParameterValue.Layers Layers parameter error.
InvalidParameterValue.LimitExceeded The parameter exceeds the length limit.
InvalidParameterValue.Memory The value of Memory does not conform to the specification. Please fix it and try again. For more information, please visit https://tencentcs.com/5jXKFnBW.
InvalidParameterValue.MemorySize MemorySize error.
InvalidParameterValue.Namespace Namespace error.
InvalidParameterValue.PublicNetConfig The PublicNetConfig parameter is invalid.
InvalidParameterValue.Runtime Runtime error.
InvalidParameterValue.SystemEnvironment The system environment variable is invalid.
InvalidParameterValue.TraceEnable The value of TraceEnable is invalid. Please modify and try again.
LimitExceeded.Eip The EIP resource exceeded the limit.
LimitExceeded.InitTimeout The value of InitTimeout has reached the upper limit. You can submit a ticket to increase it at https://tencentcs.com/7Fixwt63.
LimitExceeded.Memory The memory exceeds the upper limit.
LimitExceeded.Timeout Timeout exceeds the upper limit.
ResourceNotFound.CfsVpcNotMatch VPCs of the CFS instance and the SCF function are different.
ResourceNotFound.Cmq Cmq does not exist.
ResourceNotFound.Function The function does not exist.
ResourceNotFound.FunctionName The function does not exist.
ResourceNotFound.GetCfsNotMatch An error occurred while getting the CFS information.
ResourceNotFound.Layer The layer does not exist.
ResourceNotFound.Namespace Namespace does not exist.
ResourceNotFound.Role The role does not exist.
ResourceNotFound.Vpc The VPC or subnet does not exist.
UnauthorizedOperation.CAM CAM authentication failed.
UnsupportedOperation Unsupported operation.