tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Serverless Cloud Function
    Documentation
    Download PDF

    PutProvisionedConcurrencyConfig

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

    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

    https://scf.tencentcloudapi.com/?Action=PutProvisionedConcurrencyConfig
&FunctionName=test
&Qualifier=1
&VersionProvisionedConcurrencyNum=10
&<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.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.

    Contact Us
    Technical Support

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

    Submit a Ticket
    7x24 Phone Support
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    Privacy PolicyLegalCookie Policy