tencent cloud



Last updated: 2023-07-18 11:11:01

1. API Description

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

This API is used to set the provisioned concurrency of a non-$LATEST version of a function.

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

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 Params. The value used for this API: PutProvisionedConcurrencyConfig.
Version Yes String Common Params. The value used for this API: 2018-04-16.
Region No String Common Params. This parameter is not required for this API.
FunctionName Yes String Name of the function for which to set the provisioned concurrency
Qualifier Yes String Function version number. Note: the $LATEST version does not support provisioned concurrency
VersionProvisionedConcurrencyNum Yes Integer Provisioned concurrency amount. Note: there is an upper limit for the sum of provisioned concurrency amounts of all versions, which currently is the function's maximum concurrency quota minus 100
Namespace No String Function namespace. Default value: default
TriggerActions.N No Array of TriggerAction Scheduled provisioned concurrency scaling action
ProvisionedType No String Specifies the provisioned concurrency type.
Default: Static provisioned concurrency.
ConcurrencyUtilizationTracking: Scales the concurrency automatically according to the concurrency utilization.
If ConcurrencyUtilizationTracking is passed in,

TrackingTarget, MinCapacity and MaxCapacity are required, and VersionProvisionedConcurrencyNum must be 0.
TrackingTarget No Float The target concurrency utilization. Range: (0,1) (two decimal places)
MinCapacity No Integer The minimum number of instances. It can not be smaller than 1.
MaxCapacity No Integer The maximum number of instances

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 Setting the provisioned concurrency

Input Example

&<Common Request Parameters>

Output Example

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

5. Developer Resources


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.DebugModeStatus This operation cannot be performed in the current debugging status.
FailedOperation.FunctionVersionStatusNotActive This operation cannot be performed in the current function version status. Please try again when the version is in normal status.
FailedOperation.InsufficientBalance The current account or namespace is in arrears. Please try again when it becomes available.
FailedOperation.ProvisionCreateTimer Failed to create the scheduled provisioned concurrency scaling action
FailedOperation.ProvisionDeleteTimer Failed to delete the scheduled provisioned concurrency scaling action
FailedOperation.ProvisionedExceedAvailable Running out of available provisioned concurrency quota
FailedOperation.ProvisionedExceedReserved The provisioned concurrency exceeds the limit.
FailedOperation.ProvisionedInProgress The function version already has a provisioned concurrency setting task in progress. Please try again later.
FailedOperation.ServiceClosed ServiceClosed. Please check and try again.
FailedOperation.UnOpenedService The specified service has not been activated. Please submit a ticket for activation.
InternalError Internal error.
InvalidParameterValue Incorrect parameter value.
InvalidParameterValue.FunctionName The function does not exist.
InvalidParameterValue.MinCapacity MinCapacity parameter input error.
InvalidParameterValue.ProvisionTriggerCronConfigDuplicate Cron expression of the scheduled action already exists
InvalidParameterValue.ProvisionTriggerName TriggerName input parameter error
InvalidParameterValue.ProvisionTriggerNameDuplicate TriggerName already exists
InvalidParameterValue.ProvisionType ProvisionType input parameter error
InvalidParameterValue.Qualifier Unsupported function version.
InvalidParameterValue.TrackingTarget TrackingTarget parameter error
InvalidParameterValue.TriggerCronConfig TriggerCronConfig input parameter error
InvalidParameterValue.TriggerCronConfigTimeInterval The interval of triggering specified in TriggerCronConfig is smaller than the specified value.
InvalidParameterValue.TriggerProvisionedConcurrencyNum TriggerProvisionedConcurrencyNum input parameter error
LimitExceeded.FunctionProvisionedConcurrencyMemory The value of FunctionProvisionedConcurrencyMemory has reached the upper limit. You can submit a ticket to increase it at https://mc.tencent.com/dI7DzbBV.
LimitExceeded.FunctionTotalProvisionedConcurrencyMemory The value of FunctionTotalProvisionedConcurrencyMemory has reached the upper limit. You can submit a ticket to increase it at https://mc.tencent.com/dI7DzbBV.
LimitExceeded.FunctionTotalProvisionedConcurrencyNum The total amount of provisioned concurrency of the function has exceeded the limit.
LimitExceeded.MaxCapacity Reached the upper limit of dynamic scaling.
LimitExceeded.ProvisionTriggerAction The number of provisioned concurrency specified for the scheduled action is too large.
LimitExceeded.ProvisionTriggerInterval The interval of triggering is too short.
MissingParameter Missing parameter.
ResourceNotFound.Function The function does not exist.
ResourceNotFound.FunctionName The function does not exist.
ResourceNotFound.FunctionVersion The function version does not exist.
ResourceNotFound.Namespace Namespace does not exist.
ResourceNotFound.Version The version does not exist.
UnauthorizedOperation Unauthorized operation.
Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support