All Products
Search
Document Center

Function Compute:ListFunctions

Last Updated:Oct 08, 2024

Queries a list of functions.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

GET /2023-03-30/functions HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
prefixstringNo

The prefix of the function name.

my-func
nextTokenstringNo

The pagination token.

MTIzNCNhYmM=
limitintegerNo

The number of functions to return. The minimum value is 1 and the maximum value is 100.

10
fcVersionstringNo

The version of Function Compute to which the functions belong. Valid values: v3 and v2. v3: only lists functions of Function Compute 3.0. v2: only lists functions of Function Compute 2.0. By default, this parameter is left empty and functions in both Function Compute 2.0 and Function Compute 3.0 are listed.

v3

Response parameters

ParameterTypeDescriptionExample
ListFunctionsOutput

A list of functions.

Examples

Sample success responses

JSONformat

{
  "functions": [
    {
      "codeChecksum": "2825179536350****",
      "codeSize": 412,
      "cpu": 1,
      "createdTime": "2023-04-01T08:15:27Z",
      "customContainerConfig": {
        "accelerationInfo": {
          "status": "Ready"
        },
        "accelerationType": "default",
        "acrInstanceId": "cri-xxxxxxxxxx",
        "command": [
          "arg1"
        ],
        "entrypoint": [
          "/code/bootstrap"
        ],
        "healthCheckConfig": {
          "failureThreshold": 1,
          "httpGetUrl": "/ready",
          "initialDelaySeconds": 1,
          "periodSeconds": 1,
          "successThreshold": 2,
          "timeoutSeconds": 2
        },
        "image": "registry-vpc.cn-hangzhou.aliyuncs.com/fc-demo/helloworld:v1beta1",
        "port": 9000,
        "registryConfig": {
          "authConfig": {
            "password": "abc***",
            "userName": "admin"
          },
          "certConfig": {
            "insecure": true,
            "rootCaCertBase64": "cm9vdF9jYV9jZXJ0"
          },
          "networkConfig": {
            "securityGroupId": "sg-xxxxxxxxxxxxxx",
            "vSwitchId": "vsw-xxxxxxxxxxxxxx",
            "vpcId": "vpc-xxxxxxxxxxxxxx"
          }
        },
        "resolvedImageUri": "stand-sh-registry-vpc.cn-shanghai.cr.aliyuncs.com/fc-demo2/springboot-helloworld@sha256:68d1****0d64d6"
      },
      "customDNS": {
        "dnsOptions": [
          {
            "name": "ndots",
            "value": "2"
          }
        ],
        "nameServers": [
          "8.8.x.x"
        ],
        "searches": [
          "ns1.svc.cluster-domain.example"
        ]
      },
      "customRuntimeConfig": {
        "args": [
          "arg1"
        ],
        "command": [
          "/code/bootstrap"
        ],
        "healthCheckConfig": {
          "failureThreshold": 1,
          "httpGetUrl": "/ready",
          "initialDelaySeconds": 1,
          "periodSeconds": 1,
          "successThreshold": 2,
          "timeoutSeconds": 2
        },
        "port": 9000
      },
      "description": "my function",
      "diskSize": 512,
      "environmentVariables": {
        "key": "value1"
      },
      "functionArn": "acs:fc:cn-shanghai:123:functions/functionName",
      "functionId": "aa715851-1c20-4b89-a8fb-***",
      "functionName": "my-function-1",
      "gpuConfig": {
        "gpuMemorySize": 2048,
        "gpuType": "fc.gpu.ampere.1"
      },
      "handler": "index.handler",
      "instanceConcurrency": 1,
      "instanceLifecycleConfig": {
        "initializer": {
          "handler": "index.initializer",
          "timeout": 10
        },
        "preStop": {
          "handler": "index.initializer",
          "timeout": 10
        }
      },
      "internetAccess": true,
      "lastModifiedTime": "2023-05-01T08:15:27Z",
      "lastUpdateStatus": "InProgress",
      "lastUpdateStatusReason": "The system is currently processing the acceleration optimization for the image.",
      "lastUpdateStatusReasonCode": "ImageOptimizing",
      "layers": [
        {
          "arn": "acs:fc:cn-beijing:186824xxxxxx:layers/fc_layer/versions/1",
          "size": 421
        }
      ],
      "logConfig": {
        "enableInstanceMetrics": true,
        "enableRequestMetrics": true,
        "logBeginRule": "DefaultRegex",
        "logstore": "test-logstore",
        "project": "test-project"
      },
      "memorySize": 512,
      "nasConfig": {
        "groupId": 100,
        "mountPoints": [
          {
            "enableTLS": true,
            "mountDir": "/home/test",
            "serverAddr": "***-uni85.cn-hangzhou.nas.com:/"
          }
        ],
        "userId": 100
      },
      "ossMountConfig": {
        "mountPoints": [
          {
            "bucketName": "my-bucket",
            "bucketPath": "/my-dir",
            "endpoint": "http://oss-cn-shanghai.aliyuncs.com",
            "mountDir": "/mnt/dir",
            "readOnly": true
          }
        ]
      },
      "role": "acs:ram::188077086902****:role/fc-test",
      "runtime": "python3.10",
      "state": "Pending",
      "stateReason": "Function creating",
      "stateReasonCode": "Creating",
      "timeout": 60,
      "tracingConfig": {
        "params": {
          "key": "tracing_analysis_jaeger_endpoint"
        },
        "type": "Jaeger"
      },
      "vpcConfig": {
        "securityGroupId": "sg-bp18hj1wtxgy3b0***",
        "vSwitchIds": [
          "vsw-bp1ozpcrdc6r****"
        ],
        "vpcId": "vpc-***",
        "role": "acs:ram::188077086902****:role/fc-test"
      }
    }
  ],
  "nextToken": "next_function_name"
}

Error codes

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

Change history

Change timeSummary of changesOperation
2024-08-22The internal configuration of the API is changed, but the call is not affectedView Change Details
2024-08-22The request parameters of the API has changedView Change Details
2024-06-14The API operation is not deprecated.View Change Details
2024-02-22The internal configuration of the API is changed, but the call is not affectedView Change Details
2023-08-30API Description UpdateView Change Details
2023-08-30API Description Update. The response structure of the API has changedView Change Details
2023-06-28Add OperationView Change Details