tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Serverless Cloud Function
    Documentation
    Download PDF

    Data Types

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

    Alias

    Version alias of function

    Used by actions: ListAliases.

    Name Type Required Description
    FunctionVersion String Yes Master version pointed to by the alias
    Name String Yes Alias name
    RoutingConfig RoutingConfig Yes Routing information of alias
    Note: this field may return null, indicating that no valid values can be obtained.
    Description String No Description
    Note: this field may return null, indicating that no valid values can be obtained.
    AddTime Timestamp No Creation time
    Note: this field may return null, indicating that no valid values can be obtained.
    ModTime Timestamp No Update time
    Note: this field may return null, indicating that no valid values can be obtained.

    AsyncEvent

    Async event

    Used by actions: ListAsyncEvents.

    Name Type Description
    InvokeRequestId String Invocation request ID
    InvokeType String Invocation type
    Qualifier String Function version
    Status String Event status. Values: RUNNING; FINISHED (invoked successfully); ABORTED (invocation ended); FAILED (invocation failed)
    StartTime String Invocation start time in the format of "%Y-%m-%d %H:%M:%S.%f"
    EndTime String Invocation end time in the format of "%Y-%m-%d %H:%M:%S.%f"

    AsyncEventStatus

    Async event status

    Used by actions: GetAsyncEventStatus.

    Name Type Description
    Status String Async event status. Values: RUNNING (running); FINISHED (invoked successfully); ABORTED (invocation ended); FAILED (invocation failed).
    StatusCode Integer Request status code
    InvokeRequestId String Async execution request ID

    AsyncTriggerConfig

    Async retry configuration details of function

    Used by actions: GetFunctionEventInvokeConfig, UpdateFunctionEventInvokeConfig.

    Name Type Required Description
    RetryConfig Array of RetryConfig Yes Async retry configuration of function upon user error
    MsgTTL Integer Yes Message retention period

    Code

    Function code

    Used by actions: PublishLayerVersion, UpdateFunctionCode.

    Name Type Required Description
    CosBucketName String No Object bucket name (enter the custom part of the bucket name without -appid)
    CosObjectName String No File path of code package stored in COS, which should start with “/”
    ZipFile String No This parameter contains a .zip file (up to 50 MB) of the function code file and its dependencies. When this API is used, the content of the .zip file needs to be Base64-encoded
    CosBucketRegion String No COS region. For Beijing regions, you need to import ap-beijing. For Beijing Region 1, you need to input ap-beijing-1. For other regions, no import is required.
    DemoId String No DemoId is required if Demo is used for the creation.
    TempCosObjectName String No TempCosObjectName is required if TempCos is used for the creation.
    GitUrl String No (Disused) Git address
    GitUserName String No (Disused) Git username
    GitPassword String No (Disused) Git password
    GitPasswordSecret String No (Disused) Git password after encryption. It’s usually not required.
    GitBranch String No (Disused) Git branch
    GitDirectory String No (Disused) Directory to the codes in the Git repository.
    GitCommitId String No (Disused)
    GitUserNameSecret String No (Disused) Git username after encryption. It’s usually not required.
    ImageConfig ImageConfig No TCR image configurations

    Filter

    Key-value pair filters for conditional filtering queries, such as filtering ID, name, and status.
    If more than one filter exists, the logical relationship between these filters is AND.
    If multiple values exist in one filter, the logical relationship between these values under the same filter is OR.

    Used by actions: ListFunctions, ListTriggers.

    Name Type Required Description
    Name String Yes Fields to be filtered. Up to 10 conditions allowed.
    Values of Name: VpcId, SubnetId, ClsTopicId, ClsLogsetId, Role, CfsId, CfsMountInsId, Eip. Values limit: 1.
    Name options: Status, Runtime, FunctionType, PublicNetStatus, AsyncRunEnable, TraceEnable. Values limit: 20.
    When Name is Runtime, CustomImage refers to the image type function
    Values Array of String Yes Filter values of the field

    Function

    Function list

    Used by actions: ListFunctions.

    Name Type Description
    ModTime String Modification time
    AddTime String Creation time
    Runtime String Runtime
    Note: This parameter may return null, indicating that no valid values can be obtained.
    FunctionName String Function name
    FunctionId String Function ID
    Namespace String Namespace
    Status String Function status. For valid values and status change process, please see here
    StatusDesc String Function status details
    Description String Function description
    Tags Array of Tag Function tag
    Type String Function type. The value is HTTP or Event.
    StatusReasons Array of StatusReason Cause of function failure
    TotalProvisionedConcurrencyMem Integer Sum of provisioned concurrence memory for all function versions
    Note: this field may return null, indicating that no valid values can be obtained.
    ReservedConcurrencyMem Integer Reserved memory for function concurrence
    Note: this field may return null, indicating that no valid values can be obtained.
    AsyncRunEnable String Asynchronization attribute of the function. Values: TRUE and FALSE.
    TraceEnable String Whether to enable call tracing for ansynchronized functions. Values: TRUE and FALSE.

    FunctionLog

    Log information

    Used by actions: GetFunctionLogs.

    Name Type Description
    FunctionName String Function name
    RetMsg String Return value after the function is executed
    RequestId String RequestId corresponding to the executed function
    StartTime Timestamp Start time of the function execution
    RetCode Integer Function execution result. 0 indicates successful execution and other values indicate failure.
    InvokeFinished Integer It specifies whether the function invocation is finished. 1 indicates execution completion and other values indicate that exceptions occurred during the invocation.
    Duration Float Duration of the function execution. The unit is millisecond (ms).
    BillDuration Integer Function billing duration. The unit is millisecond (ms). The value is rounded up to a multiple of 100 ms.
    MemUsage Integer Actual memory size used during the function execution. The unit is byte.
    Log String Function execution logs
    Level String Log level
    Source String Log source
    RetryNum Integer Number of retries

    FunctionVersion

    Function version information

    Used by actions: ListVersionByFunction.

    Name Type Required Description
    Version String Yes Function version name
    Description String No Version description
    Note: This field may return null, indicating that no valid values is found.
    AddTime Timestamp No The creation time
    Note: This field may return null, indicating that no valid value was found.
    ModTime Timestamp No Update time
    Note: This field may return null, indicating that no valid value was found.
    Status String No Version status
    Note: this field may return null, indicating that no valid values can be obtained.

    ImageConfig

    TCR image information

    Used by actions: PublishLayerVersion, UpdateFunctionCode.

    Name Type Required Description
    ImageType String Yes Image repository type, which can be personal or enterprise
    ImageUri String Yes {domain}/{namespace}/{imageName}:{tag}@{digest}
    RegistryId String No The temp token that a TCR Enterprise instance uses to obtain an image. It’s required when ImageType is enterprise.
    Note: this field may return null, indicating that no valid values can be obtained.
    EntryPoint String No Disused
    Note: this field may return null, indicating that no valid values can be obtained.
    Command String No The command to start up the container, such as python. If it’s not specified, Entrypoint in Dockerfile is used.
    Note: this field may return null, indicating that no valid values can be obtained.
    Args String No The parameters to start up the container. Separate parameters with spaces, such as u app.py. If it’s not specified, CMD in Dockerfile is used.<br/>Note: This field may return null`, indicating that no valid value can be found.
    ContainerImageAccelerate Boolean No Whether to enable image acceleration. It defaults to False.
    Note: This field may return null, indicating that no valid values can be obtained.
    ImagePort Integer No Image function port settings
    -1: No port-specific image functions
    0: Default port (Port 9000)
    Others: Special ports
    Note: This field may return null, indicating that no valid values can be obtained.

    LayerVersionInfo

    Layer version information

    Used by actions: ListLayerVersions, ListLayers.

    Name Type Description
    CompatibleRuntimes Array of String Runtime applicable to a version
    Note: This field may return null, indicating that no valid values can be obtained.
    AddTime String Creation time
    Description String Version description
    Note: This field may return null, indicating that no valid values can be obtained.
    LicenseInfo String License information
    Note: This field may return null, indicating that no valid values can be obtained.
    LayerVersion Integer Version number
    LayerName String Layer name
    Status String Current status of specific layer version. For valid values, please see here
    Stamp String Stamp
    Note: This field may return null, indicating that no valid values can be obtained.

    LimitsInfo

    Limit information

    Used by actions: GetAccount.

    Name Type Description
    NamespacesCount Integer Limit of namespace quantity
    Namespace Array of NamespaceLimit Namespace limit information

    LogFilter

    Log filtering criteria, which is for distinguishing between logs of successful and failed execution

    Used by actions: GetFunctionLogs.

    Name Type Required Description
    RetCode String No Values of filter.RetCode include:
    not0, indicating that only logs of failed execution will be returned.
    is0, indicating that only logs of successful execution will be returned.
    TimeLimitExceeded, indicating that logs of function invocations which timed out will be returned.
    ResourceLimitExceeded, indicating that logs of function invocations during which resources exceeded the upper limit will be returned.
    UserCodeException, indicating that logs of function invocations during which a user code error occurred will be returned.
    Blank, indicating that all logs will be returned.

    LogSearchContext

    Log search context

    Used by actions: GetFunctionLogs.

    Name Type Required Description
    Offset String Yes Offset.
    Limit Integer Yes Log record number
    Keyword String No Log keyword
    Type String No Log type. The value is Application (default) or Platform.

    Namespace

    Namespace

    Used by actions: ListNamespaces.

    Name Type Description
    ModTime Timestamp Creation time of the namespace
    AddTime Timestamp Modification time of the namespace
    Description String Namespace description
    Name String Namespace name
    Type String The default value is default. TCB indicates that the namespace is developed and created through the mini-program cloud.

    NamespaceLimit

    Namespace limit

    Used by actions: GetAccount.

    Name Type Description
    FunctionsCount Integer Total number of functions
    Trigger TriggerCount Trigger information
    Namespace String Namespace name
    ConcurrentExecutions Integer Concurrency
    TimeoutLimit Integer Timeout limit
    TestModelLimit Integer Test event limit
    Note: this field may return null, indicating that no valid values can be obtained.
    InitTimeoutLimit Integer Initialization timeout limit
    RetryNumLimit Integer Limit of async retry attempt quantity
    MinMsgTTL Integer Lower limit of message retention time for async retry
    MaxMsgTTL Integer Upper limit of message retention time for async retry

    NamespaceUsage

    Namespace usage information

    Used by actions: GetAccount.

    Name Type Description
    Functions Array of String Function array
    Namespace String Namespace name
    FunctionsCount Integer Number of functions in namespace
    TotalConcurrencyMem Integer Total memory quota of the namespace
    Note: This field may return null, indicating that no valid values can be obtained.
    TotalAllocatedConcurrencyMem Integer Concurrency usage of the namespace
    Note: This field may return null, indicating that no valid value can be obtained.
    TotalAllocatedProvisionedMem Integer Provisioned concurrency usage of the namespace
    Note: This field may return null, indicating that no valid value can be obtained.

    RequestStatus

    Running status of the function

    Used by actions: GetRequestStatus.

    Name Type Description
    FunctionName String Function name
    RetMsg String Return value after the function is executed
    RequestId String Request ID
    StartTime String Request start time
    RetCode Integer Result of the request. 0: succeeded, 1: running, -1: exception
    Duration Float Time consumed for the request in ms
    MemUsage Float Time consumed by the request in MB
    RetryNum Integer Retry Attempts

    Result

    Response of the executed function

    Used by actions: Invoke, InvokeFunction.

    Name Type Description
    Log String It indicates the log output during the function execution. Null is returned for asynchronous invocations.
    RetMsg String It indicates the response from the executed function. Null is returned for asynchronous invocations.
    ErrMsg String It indicates the error message of the executed function. Null is returned for asynchronous invocations.
    MemUsage Integer It indicates the memory size (in bytes) when the function is running. Null is returned for asynchronous invocations.
    Duration Float It indicates the duration (in milliseconds) required for running the function. Null is returned for asynchronous invocations.
    BillDuration Integer It indicates the billing duration (in milliseconds) for the function. Null is returned for asynchronous invocations.
    FunctionRequestId String ID of the executed function
    InvokeResult Integer The status code of the request. It’s not available for Invoke API.

    RetryConfig

    Async retry configuration

    Used by actions: GetFunctionEventInvokeConfig, UpdateFunctionEventInvokeConfig.

    Name Type Required Description
    RetryNum Integer Yes Number of retry attempts

    RoutingConfig

    Version routing configuration of alias

    Used by actions: CreateAlias, GetAlias, ListAliases, UpdateAlias.

    Name Type Required Description
    AdditionalVersionWeights Array of VersionWeight No Additional version with random weight-based routing
    AddtionVersionMatchs Array of VersionMatch No Additional version with rule-based routing

    SearchKey

    Key-value condition for keyword search

    Used by actions: ListNamespaces.

    Name Type Required Description
    Key String Yes Search range
    Value String Yes Keyword for search

    StatusReason

    State reason description

    Used by actions: ListFunctions.

    Name Type Description
    ErrorCode String Error code
    ErrorMessage String Error message

    Tag

    Function tag

    Used by actions: ListFunctions.

    Name Type Required Description
    Key String Yes Tag key
    Value String Yes Tag value

    TimeInterval

    Left-closed-right-open time range between the start time and end time in the format of "%Y-%m-%d %H:%M:%S"

    Used by actions: ListAsyncEvents.

    Name Type Required Description
    Start String Yes Start time (inclusive) in the format of "%Y-%m-%d %H:%M:%S"
    End String Yes End time (exclusive) in the format of "%Y-%m-%d %H:%M:%S"

    Trigger

    Trigger type

    Used by actions: CreateTrigger.

    Name Type Description
    ModTime Timestamp Latest modification time of the trigger
    Type String Trigger type
    TriggerDesc String Detailed trigger configuration
    TriggerName String Trigger name
    AddTime Timestamp Creation time of the trigger
    Enable Integer Enabling switch
    CustomArgument String Custom parameter
    AvailableStatus String Trigger status
    Qualifier String The alias or version bound with the trigger
    Description String Trigger description

    TriggerAction

    Details of a scheduled provisioned concurrency scaling action

    Used by actions: GetProvisionedConcurrencyConfig, PutProvisionedConcurrencyConfig.

    Name Type Required Description
    TriggerName String Yes Scheduled action name
    Note: this field may return null, indicating that no valid values can be obtained.
    TriggerProvisionedConcurrencyNum Integer Yes Target provisioned concurrency of the scheduled scaling action
    Note: this field may return null, indicating that no valid values can be obtained.
    TriggerCronConfig String Yes Trigger time of the scheduled action in Cron expression. Seven fields are required and should be separated with a space.
    Note: this field may return null, indicating that no valid values can be obtained.
    ProvisionedType String No The provision type. Value: Default
    Note: This field may return null, indicating that no valid value can be found.

    TriggerCount

    TriggerCount describes the numbers of triggers in different types

    Used by actions: GetAccount.

    Name Type Description
    Cos Integer Number of COS triggers
    Timer Integer Number of timer triggers
    Cmq Integer Number of CMQ triggers
    Total Integer Total number of triggers
    Ckafka Integer Number of CKafka triggers
    Apigw Integer Number of API Gateway triggers
    Cls Integer Number of CLS triggers
    Clb Integer Number of CLB triggers
    Mps Integer Number of MPS triggers
    Cm Integer Number of CM triggers
    Vod Integer Number of VOD triggers
    Eb Integer Number of EventBridge triggers
    Note: This field may return null, indicating that no valid values can be obtained.

    TriggerInfo

    Trigger information

    Used by actions: ListTriggers.

    Name Type Description
    Enable Integer Whether to enable
    Qualifier String Function version or alias
    TriggerName String Trigger name
    Type String Trigger type
    TriggerDesc String Detailed configuration of trigger
    AvailableStatus String Whether the trigger is available
    CustomArgument String Custom parameter
    Note: this field may return null, indicating that no valid values can be obtained.
    AddTime Timestamp Trigger creation time
    ModTime Timestamp Trigger last modified time
    Description String Description of a custom trigger
    Note: This parameter may return null, indicating that no valid values can be obtained.

    UsageInfo

    Usage information

    Used by actions: GetAccount.

    Name Type Description
    NamespacesCount Integer Number of namespaces
    Namespace Array of NamespaceUsage Namespace details
    TotalConcurrencyMem Integer Upper limit of user concurrency memory in the current region
    TotalAllocatedConcurrencyMem Integer Quota of configured user concurrency memory in the current region
    UserConcurrencyMemLimit Integer Quota of account concurrency actually configured by user

    VersionMatch

    Function version with match rule

    Used by actions: CreateAlias, GetAlias, UpdateAlias.

    Name Type Required Description
    Version String Yes Function version name
    Key String Yes Matching rule key. When the API is called, pass in the key to route the request to the specified version based on the matching rule
    Header method:
    Enter "invoke.headers.User" for key and pass in RoutingKey:{"User":"value"} when invoking a function through invoke for invocation based on rule matching
    Method String Yes Match method. Valid values:
    range: range match
    exact: exact string match
    Expression String Yes Rule requirements for range match:
    It should be described in an open or closed range, i.e., (a,b) or [a,b], where both a and b are integers
    Rule requirements for exact match:
    Exact string match

    VersionProvisionedConcurrencyInfo

    Provisioned concurrency information of function version, including the set provisioned concurrency amount, available provisioned concurrency amount, and provisioned concurrency setting task status.

    Used by actions: GetProvisionedConcurrencyConfig.

    Name Type Description
    AllocatedProvisionedConcurrencyNum Integer Set provisioned concurrency amount.
    AvailableProvisionedConcurrencyNum Integer Currently available provisioned concurrency amount.
    Status String Provisioned concurrency setting task status. Done: completed; InProgress: in progress; Failed: partially or completely failed.
    StatusReason String Status description of provisioned concurrency setting task.
    Qualifier String Function version number
    TriggerActions Array of TriggerAction List of scheduled provisioned concurrency scaling actions
    Note: this field may return null, indicating that no valid values can be obtained.

    VersionWeight

    Function version with weight

    Used by actions: CreateAlias, GetAlias, UpdateAlias.

    Name Type Required Description
    Version String Yes Function version name
    Weight Float Yes Version weight
    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