批量获取函数信息。只包含函数基本配置，不包含函数代码。 ## 请求说明 * 请求方式：POST * 请求地址：http://open.volcengineapi.com/?Action=ListFunctions&Version=2024\-06\-06 ## 调试 ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |ListFunctions |接口名称。当前 API 的名称为 `ListFunctions`。 | |Version |String |是 |2024\-06\-06 |接口版本。当前 API 的版本为 `2024-06-06`。 | |PageNumber |Integer |否 |1 |分页参数，当前页码，默认为 1。 | |PageSize |Integer |否 |10 |分页参数，每页大小，默认为 10。 | |Filters |Array of [Filter](#filter) |否 |[{"Name":"Ids","Values":["q06q\*\*\*\*","rx1b\*\*\*\*"]}] |函数过滤条件。 | |TagFilters |Array of [TagFilter](#tagfilter) |否 |[{"Key":"business","Values":["ecommerce"]}] |函数标签。 | ### Filter |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Name |String |否 |Ids |查询的筛选键（Key）。可取值如下：|\ | | | | ||\ | | | | |* **Id**: 函数 ID。|\ | | | | |* **Ids**: 多个函数 ID。|\ | | | | |* **Name**: 函数名字。 | |Values |Array of String |否 |["q06\*\*\*\*","rx1\*\*\*\*"] |查询的筛选值（Value）。多个取值之间用半角逗号（`,`）分割。 | ### TagFilter |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Key |String |否 | |根据标签查询资源时指定的标签键。 | |Values |Array of String |否 | |根据标签查询资源时指定的标签值。 | ## 请求示例 ```JSON { "PageNumber": 1, "PageSize": 10 } ``` ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Items |Array of [Function](#function) |\- |函数列表。 | |Total |Integer |180 |函数总数。 | ### Function |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Id |String |pq\*\*\*\*\*\* |函数 ID。 | |Envs |Array of [EnvVar](#envvar) |\- |函数环境变量。 | |Name |String |official\-site |函数名称。 | |Tags |Array of [Tag](#tag) |\- |函数标签。 | |Owner |String |22\*\*\*\*\*\* |函数所有者（账号 Id）。 | |Source |String | |用户输入的代码/镜像地址。 | |Runtime |String |python3.8/v1 |函数运行时。 | |CodeSize |Integer |473 |代码包大小。 | |MemoryMB |Integer |1024 |单实例最大内存。 | |TlsConfig |Object of [TlsConfig](#tlsconfig) |\- |函数日志配置。 | |VpcConfig |Object of [VpcConfig](#vpcconfig) |\- |VPC 配置。 | |NasStorage |Object of [NasStorage](#nasstorage) |\- |文件存储 NAS 配置。 | |SourceType |String |tos |代码 Source 类型，支持 tos，zip，image(白名单账户支持 native/v1 自定义镜像)。 | |Description |String |轻量级官网 |函数描述。 | |CreationTime |String |2024\-06\-14 15:31:07.143863441 +0800 CST m=+88714.902440864 |函数创建时间。 | |InstanceType |String |nvidia\-tesla\-l4 |函数实例的实例类型：|\ | | | ||\ | | | |* 空值：CPU 实例。|\ | | | |* 非空值：GPU 实例。 | |CodeSizeLimit |Integer |256 |代代码包大小上限:|\ | | | ||\ | | | |* SourceType=zip，CodeSizeLimit=15MB。|\ | | | |* SourceType=tos，CodeSizeLimit=256MB。 | |ExclusiveMode |Boolean |false |独占模式开关。|\ | | | ||\ | | | |* true：关闭单实例多并发，即同一时刻单实例只能处理一个请求的独占模式。|\ | | | |* false（默认）：开启单实例多并发，即同一时刻单实例可处理多个请求的非独占模式，可通过 MaxConcurrency 设置单实例能够承载的最大并发请求数量。 | |TriggersCount |Integer |0 |该函数的触发器个数。 | |InitializerSec |Integer |30 |函数初始化超时配置。 | |LastUpdateTime |String |2024\-06\-14 15:31:07.143863491 +0800 CST m=+88714.902440914 |更新时间。 | |MaxConcurrency |Integer |100 |单实例最大并发。 | |RequestTimeout |Integer |30 |请求超时（单位秒）。 | |SourceLocation |String |https://vefaas.tos\-s3\-cn.volces.com/template_dir/666ad75b9124c400072abcvefaas\-python3.9\-default.zip?X\-Amz\-\*\*\*\*\*\* |代码/镜像的来源地址。 | |TosMountConfig |Object of [TosMountConfig](#tosmountconfig) |\- |TOS 对象存储挂载配置。 | |Port |Integer |8000 |实例的自定义监听端口（目前只支持 native/v1 运行时）。 | |Command |String |./run.sh |实例的自定义启动命令（目前只支持 native/v1 运行时）。 | |CpuStrategy |String |always |函数 CPU 计费策略，当微服务应用类型的函数时，该字段为 `always`，表示至少有一个实例在运行。 | |ProjectName |String |default |函数所属项目名称。 | |Cell |String |2 |函数所属CELL | |Role |String |trn:iam::1400000044:role/VeFaaSDefaultRole |函数实例绑定 IAM 角色 | |FunctionType |String |sandbox |函数类型。参数值说明：|\ | | | ||\ | | | |* **sandbox**：SandBox 类型的函数。 | |EnableApmplus |Boolean | |开启应用监控。 | ### EnvVar |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Key |String |business_type |沙箱实例环境变量的键。 | |Value |String |free |沙箱实例环境变量的值。 | ### Tag |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Key |String |business |标签键。 | |Value |String |ecommerce |标签值。 | ### TlsConfig |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |EnableLog |Boolean |false |是否启用日志功能，参数值：|\ | | | ||\ | | | |* **true**：开启，函数的 stdout/stderr 日志将被采集至日志服务的指定日志项目和日志主题中。|\ | | | |* **false**：关闭，不采集日志。 | |TlsTopicId |String |0cd4e4c4\-5436\-4b05\-b39e\-\*\*\*\* |TLS 日志主题 ID。 | |TlsProjectId |String |48f49d74\-cd50\-4591\-a3d0\-\*\*\*\* |TLS 日志项目 ID。 | ### VpcConfig |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |EnableVpc |Boolean |false |函数是否开启 VPC 访问。参数值：|\ | | | ||\ | | | |* **false**：不启用，函数可通过默认网卡访问公网。|\ | | | |* **true**：启用，函数可访问指定 VPC 中的资源。 | |VpcId |String |vpc\-2d73mgm\*\*\*\* |函数所属 VPC 的 ID。 | |SubnetIds |Array of String |["subnet\-mj1l\*\*\*\*\*\*"] |函数开启 VPC 访问后，对应的子网 ID。 | |SecurityGroupIds |Array of String |["sg\-3re8ffwjclybk5zsk\*\*\*\*"] |函数开启 VPC 访问后，对应的安全组 ID。 | |EnableSharedInternetAccess |Boolean |false |函数访问公网开关。是否通过函数服务的 VPC 共享 NAT 网关，访问公网。参数值：|\ | | | ||\ | | | |* **true**：开启，通过默认网卡访问公网。会产生公网出流量费用。|\ | | | |* **false**：关闭，函数无法通过默认网卡访问公网。 | ### NasStorage |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |EnableNas |Boolean |false |是否开启 NAS 存储挂载，参数值：|\ | | | ||\ | | | |* **true**：开启，将数据存储至 NAS。|\ | | | |* **false**：不开启。 | |NasConfigs |Array of [NasConfig](#nasconfig) |\- |NAS 存储配置。 | ### TosMountConfig |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |EnableTos |Boolean |false |是否开启 TOS 存储挂载，参数值：|\ | | | ||\ | | | |* **true**：开启，将数据存储至 TOS。|\ | | | |* **false**：不开启。 | |Credentials |Object of [Credentials](#credentials) |\- |开启 TOS 存储挂载后，需要提供具有 TOS 域名访问权限的访问密钥（AK/SK）。 | |MountPoints |Array of [TosMountPoint](#tosmountpoint) |\- |开启 TOS 存储挂载后需要提供 TOS 存储配置列表。最多不超过 5 个。 | ### NasConfig |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Gid |Long |1000 |文件系统中的用户组。暂时不支持自定义，如果提供该参数，参数值必须和函数 run user gid 保持一致，取值为：1000。 | |Uid |Long |1000 |文件系统中的用户。暂时不支持自定义，如果提供该参数，参数值必须和函数 run user uid 保持一致，取值为：1000。 | |RemotePath |String |/ |文件系统远端目录。长度 1~128 个字符，只能以“`/`”开头，支持大小写字母、数字和特殊字符（`- . _ ~ / : @ = + ? #`）。 | |FileSystemId |String |enas\-cns\*\*\*\*\*\* |NAS 文件系统 ID。 | |MountPointId |String |mount\-63\*\*\*\*\*\* |NAS 挂载点 ID。 | |LocalMountPath |String |/mnt/nas |函数本地挂载目录。长度 1~128 个字符，只能以“`/`”开头，支持大小写字母、数字和特殊字符（`- . _ ~ / : @ = + ? #`）。 | ### Credentials |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |AccessKeyId |String |\*\*\*\*\*\* |火山引擎账号的 AccessKey ID（AK）。获取方式，请参见 [访问密钥使用指南](https://www.volcengine.com/docs/6291/65568)。 | |SecretAccessKey |String |\*\*\*\*\*\* |火山引擎账号的 Secret Access Key（SK）。获取方式，请参见 [访问密钥使用指南](https://www.volcengine.com/docs/6291/65568)。 | ### TosMountPoint |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Endpoint |String |http://tos\-cn\-beijing.ivolces.com |TOS 访问域名。 | |ReadOnly |Boolean |true |函数本地目录访问权限，挂载 TOS Bucket 后，函数本地挂载目录的访问权限是否为只读，参数值：|\ | | | ||\ | | | |* **true**：只读|\ | | | |* **false**（默认）：读写 | |BucketName |String |ai\-model |TOS 存储桶名称 | |BucketPath |String |/ |挂载的 TOS Bucket 路径。 | |LocalMountPath |String |/mnt/tos |函数本地挂载目录。 | ## 返回示例 ```JSON HTTP/1.1 200 OK Content-Type: application/json { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "ListFunctions", "Version": "2024-06-06", "Service": "vefaas", "Region": "cn-beijing" }, "Result": { "Items": [ { "Id": "95hl16re", "Name": "official-site", "Description": "", "Runtime": "vefaas.base.python3.12.v1", "ExclusiveMode": false, "RequestTimeout": 30, "MaxConcurrency": 100, "MemoryMB": 1024, "CodeSizeLimit": 0, "SourceType": "tos", "VpcConfig": { "EnableVpc": false }, "CreationTime": "2024-07-02 05:46:38.444 +0000 UTC", "LastUpdateTime": "2024-07-02 05:46:38.444 +0000 UTC", "TlsConfig": { "EnableLog": false }, "ResourcePoolId": "ujdsugfffv", "Owner": "1400000044", "UseStatus": "", "DebugInstanceEnable": false, "InstanceType": "", "InitializerSec": 0, "MigrateToVciPublic": false, "EnableDumaInstance": false } ], "Total": 180 } } ``` ## 错误码当前接口暂无独立错误码，若接口调用返回异常，可参考 [公共错误码](https://www.volcengine.com/docs/6662/1261480)进行故障排查。