All Products
Search
Document Center

Function Compute:ListFunctions

Last Updated:Nov 06, 2024

Queries functions.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
fc:ListFunctionsget
  • All Resources
    *
    none
none

Request syntax

GET /2021-04-06/services/{serviceName}/functions HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
serviceNamestringYes

The name of the service.

demoService
qualifierstringNo

The version or alias of the service.

LATEST
limitintegerNo

The maximum number of resources to return. Default value: 20. Maximum value: 100. The number of returned resources is less than or equal to the specified number.

20
nextTokenstringNo

The token required to obtain more results. If the number of resources exceeds the limit, the nextToken parameter is returned. You can include the parameter in subsequent calls to obtain more results. You do not need to provide this parameter in the first call.

8bj81uI8n****
prefixstringNo

The prefix that the names of returned resources must contain.

demoFunctionsPrefix
startKeystringNo

The starting position of the result list. The returned resources are sorted in alphabetical order, and the resources that include and follow the resource specified by the startKey parameter are returned.

demoStartKey
X-Fc-Account-IdstringNo

The ID of your Alibaba Cloud account.

188077086902****
X-Fc-DatestringNo

The time when the function is invoked. The format is EEE,d MMM yyyy HH:mm:ss GMT.

Wed, 11 May 2022 09:00:00 GMT
X-Fc-Trace-IdstringNo

The custom request ID.

rid281s******

Response parameters

ParameterTypeDescriptionExample
object

The returned data.

functionsarray<object>

The information about functions.

functionobject

The definition of the function.

codeChecksumstring

The CRC64 value of the function code package.

5434025278388143772
codeSizelong

The size of the function code package returned by the system. Unit: bytes.

1024
createdTimestring

The time when the function was created.

2016-08-15T15:00:00.000+0000
customContainerConfigCustomContainerConfig

The configurations of the Custom Container runtime.

descriptionstring

The description of the function.

This is a demo hello world function
environmentVariablesobject

The environment variables that are configured for the function. You can obtain the values of the environment variables from the function.

string

The environment variables that you configured for the function.

{"key":"value"}
functionIdstring

The ID generated by the system for each function. The ID is globally unique.

2d28e0e9-9ba5-4eed-8b1a-d3d9cd24****
functionNamestring

The function name.

demo-function
handlerstring

The handler of the function.

index.handler
lastModifiedTimestring

The time when the function was last modified.

2016-08-15T17:00:00.000+0000
memorySizeinteger

The memory size of the function. Unit: MB.

512
runtimestring

The runtime of the function. Valid values: nodejs16, nodejs14, nodejs12, nodejs10, nodejs8, nodejs6, nodejs4.4, python3.10, python3.9, python3, python2.7, java11, java8, go1, php7.2, dotnetcore3.1, dotnetcore2.1, custom.debian10, custom, and custom-container. For more information, see Runtimes that are supported by Function Compute.

python3.9
timeoutinteger

The timeout period for the function to run. Unit: seconds. Default value: 60. Minimum value: 1. Maximum value: 600. When this period expires, the execution of the function is terminated.

10
initializationTimeoutinteger

The timeout period for the Initializer hook to run. Unit: seconds. Default value: 3. Minimum value: 1. Maximum value: 300. When the period ends, the execution of the Initializer hook is terminated.

60
initializerstring

The handler of the initializer function. The format of the value varies based on the programming language that you use. For more information, see Initializer function.

index.handler
caPortinteger

The port on which the HTTP server listens for the custom runtime or Custom Container runtime.

9000
instanceConcurrencyinteger

The number of requests that can be concurrently processed by a single instance.

10
instanceSoftConcurrencyinteger

The soft concurrency of the instance. You can use this property to implement graceful scale-ups for instances. If the number of concurrent requests on an instance is greater than the soft concurrency value of the instance, an instance scale-up is triggered. For example, if your instance requires a long time to start, you can specify a suitable soft concurrency to start the instance in advance.

The value must be less than or equal to that of instanceConcurrency.

5
instanceTypestring

The instance type of the function. Valid values:

  • e1: elastic instances
  • c1: performance instances
  • fc.gpu.tesla.1: GPU-accelerated instances with Tesla series cards
  • fc.gpu.ampere.1: GPU-accelerated instances with Ampere series cards
  • fc.gpu.ada.1: GPU-accelerated instances with Ada series cards
  • g1: same as fc.gpu.tesla.1
e1
layersarray

A list of layers.

Note If multiple layers exist, the layers are merged based on the array subscripts in descending order. The content of a layer with a smaller subscript overwrites that of a larger subscript.
layerstring

The ARN of the layer.

02f81d283888f5ec63442a88fe82b260#Layer-name#1
layersArnV2array

A list of layer ARNs.

layerstring
acs:fc:cn-hangzhou:official:layers/Python310/versions/2
instanceLifecycleConfigInstanceLifecycleConfig

The lifecycle configurations of instances.

customDNSCustomDNS

The custom Domain Name System (DNS) settings of the function.

customRuntimeConfigCustomRuntimeConfig

The custom runtime configurations.

customHealthCheckConfigCustomHealthCheckConfig

The custom health check configurations of the function. This parameter is applicable only to custom runtimes and Custom Container runtimes.

cpufloat

The CPU size of the function. Unit: vCPUs. The value is a multiple of 0.05 vCPUs.

1.5
diskSizeinteger

The disk size of the function. Unit: MB. Valid values: 512 MB and 10240 MB.

512
gpuMemorySizeinteger

The GPU memory size of the function. Unit: MB, which is a multiple of 1024MB.

2048
nextTokenstring

The token used to obtain more results. If this parameter is not returned, all the layers are returned.

8bj81uI8n****

Examples

Sample success responses

JSONformat

{
  "functions": [
    {
      "codeChecksum": "5434025278388143772",
      "codeSize": 1024,
      "createdTime": "2016-08-15T15:00:00.000+0000",
      "customContainerConfig": {
        "args": "[\"-arg1\", \"value1\"]",
        "command": "[\"/code/myserver\"]",
        "image": "registry-vpc.cn-hangzhou.aliyuncs.com/fc-demo/helloworld:v1beta1",
        "accelerationType": "Default",
        "instanceID": "cri-xxxxxxxxxx",
        "webServerMode": true
      },
      "description": "This is a demo hello world function",
      "environmentVariables": {
        "key": "{\"key\":\"value\"}"
      },
      "functionId": "2d28e0e9-9ba5-4eed-8b1a-d3d9cd24****",
      "functionName": "demo-function",
      "handler": "index.handler",
      "lastModifiedTime": "2016-08-15T17:00:00.000+0000",
      "memorySize": 512,
      "runtime": "python3.9",
      "timeout": 10,
      "initializationTimeout": 60,
      "initializer": "index.handler",
      "caPort": 9000,
      "instanceConcurrency": 10,
      "instanceSoftConcurrency": 5,
      "instanceType": "e1",
      "layers": [
        "02f81d283888f5ec63442a88fe82b260#Layer-name#1"
      ],
      "layersArnV2": [
        "acs:fc:cn-hangzhou:official:layers/Python310/versions/2"
      ],
      "instanceLifecycleConfig": {
        "preFreeze": {
          "handler": "",
          "timeout": 0
        },
        "preStop": {
          "handler": "",
          "timeout": 0
        }
      },
      "customDNS": {
        "nameServers": [
          "8.8.8.8"
        ],
        "searches": [
          "ns1.svc.cluster-domain.example"
        ],
        "dnsOptions": [
          {
            "name": "ndots",
            "value": "2"
          }
        ]
      },
      "customRuntimeConfig": {
        "command": [
          "/code/myBootstrap"
        ],
        "args": [
          "args1"
        ]
      },
      "customHealthCheckConfig": {
        "httpGetUrl": "",
        "initialDelaySeconds": 0,
        "periodSeconds": 0,
        "timeoutSeconds": 0,
        "failureThreshold": 0,
        "successThreshold": 0
      },
      "cpu": 1.5,
      "diskSize": 512,
      "gpuMemorySize": 2048
    }
  ],
  "nextToken": "8bj81uI8n****"
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-12-22The response structure of the API has changedView Change Details
2022-11-28The internal configuration of the API is changed, but the call is not affectedView Change Details
2021-06-30The request parameters of the API has changedView Change Details
2021-06-30The request parameters of the API has changedView Change Details
2021-06-30The request parameters of the API has changedView Change Details