ListRevisions--函数服务-火山引擎

文档中心

立即注册

导航

ListRevisions

最近更新时间：2025.01.07 10:41:17首次发布时间：2024.08.08 10:29:16

批量获取函数的版本配置信息。

请求说明

请求方式：POST
请求地址：http://open.volcengineapi.com/?Action=ListRevisions&Version=2024-06-06

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	ListRevisions	接口名称。当前 API 的名称为 `ListRevisions`。
Version	String	是	2024-06-06	接口版本。当前 API 的版本为 `2024-06-06`。
FunctionId	String	是		函数 ID。
PageNumber	Integer	否	1	分页参数，当前页码，默认为 1。
PageSize	Integer	否	10	分页参数，每页大小，默认为 10。
Filters	Array of Filter	否	-	查询过滤条件。

Filter

参数	类型	是否必选	示例值	描述
Name	String	否	RevisionNumber	查询的筛选键名, 仅支持 RevisionNumber（版本号）。说明过滤值不支持模糊查询。
Values	Array of String	否	["2"]	查询的筛选值，是一个数组。

请求示例

POST http://open.volcengineapi.com/?Action=ListRevisions&Version=2024-06-06 HTTP/1.1
Content-Type: application/json
{
    "FunctionId": "",
    "PageNumber": 1,
    "PageSize": 10,
    "Filters": [
        {
            "Name": "RevisionNumber",
            "Value": [
                "2"
            ]
        }
    ]
}

返回参数

参数	类型	示例值	描述
Items	Array of FunctionRevision	-	函数版本详细信息列表。
Total	Integer	1	返回列表数据的总量。

FunctionRevision

参数	类型	示例值	描述
Id	String	nw******	函数 ID。
Envs	Array of EnvVar	-	函数环境变量。
Name	String	official-site	函数名字。
Source	String	templates/vefaas-python38-default.zip	代码/镜像源。
Runtime	String	python3.8/v1	函数运行时。
CodeSize	Integer	1024	代码包大小。
MemoryMB	Integer	1024	单实例最大内存。单位：MiB。取值范围：512~4096。说明取值以 512 为梯度。默认值：1024。
TlsConfig	Object of TlsConfig	-	函数 TLS 日志配置。
VpcConfig	Object of VpcConfig	-	VPC 配置。
NasStorage	Object of NasStorage	-	文件存储 NAS 挂载配置。
SourceType	String	tos	代码 Source 类型。
Description	String	This is a description	函数描述。
MaxReplicas	Integer	10	最大实例数量。
CreationTime	String	2020-05-20T13:00:55Z	函数创建时间。
InstanceType	String	nvidia-tesla-l4	函数实例的实例类型。空值：CPU 实例。非空值：GPU 实例。
CodeSizeLimit	Integer	64	代码包大小上限。仅火山引擎账号（主账号）可配置。默认值：64 MiB。 Native 函数默认值：256 MiB。
ExclusiveMode	Boolean	false	独占模式开关。 true：关闭单实例多并发，即同一时刻单实例只能处理一个请求的独占模式。 false（默认）：开启单实例多并发，即同一时刻单实例可处理多个请求的非独占模式，可通过 MaxConcurrency 设置单实例能够承载的最大并发请求数量。
InitializerSec	Integer	30	函数初始化超时配置。
MaxConcurrency	Integer	100	单实例最大并发。`ExclusiveMode=false`时生效，取值范围：10~1000。
RequestTimeout	Integer	30	请求超时时间。单位：秒。取值范围：1~900。默认值：30。
RevisionNumber	Integer	1	函数版本号。
SourceLocation	String	tos://tos-cn-beijing.volces.com/test.zip	代码/镜像的来源地址。
TosMountConfig	Object of TosMountConfig	-	对象存储 TOS 挂载配置。
RevisionDescription	String	This is a revision description	函数版本描述。
RevisionCreationTime	String	2020-05-20T13:00:55Z	版本创建时间。
HealthCheckConfig	Object of HealthCheckConfig	-	HealthCheckConfig 健康检查配置。

EnvVar

参数	类型	示例值	描述
Key	String	business_type	环境变量的 Key。1 ~ 63 个字符，字符中可包含英文、数字以及下划线（_），并且不能以数字开头。同一函数下 Key 唯一。
Value	String	free	环境变量的值。

TlsConfig

参数	类型	示例值	描述
EnableLog	Boolean	false	TLS 日志功能开关。 true：开启，函数的 stdout/stderr 日志将被采集至日志服务的指定日志项目和日志主题中。 false：关闭，不采集日志。
TlsTopicId	String	tls-vefaas-logstore	TLS 日志主题 ID。
TlsProjectId	String	tls-vefaas	TLS 日志项目 ID。

参数

类型

示例值

描述

EnableLog

Boolean

false

TLS 日志功能开关。

true：开启，函数的 stdout/stderr 日志将被采集至日志服务的指定日志项目和日志主题中。
false：关闭，不采集日志。

TlsTopicId

String

tls-vefaas-logstore

TLS 日志主题 ID。

TlsProjectId

String

tls-vefaas

TLS 日志项目 ID。

VpcConfig

参数	类型	示例值	描述
VpcId	String	vpc-3rf8******	VPC ID。如果 VPC ID 为空字符串，代表删除当前 VPC 配置。
EnableVpc	Boolean	false	函数是否开启私有网络访问。
SubnetIds	Array of String	subnet-mj1l******	子网 ID。
SecurityGroupIds	Array of String	sg-rs6s******	安全组 ID。
EnableSharedInternetAccess	Boolean	false	函数访问公网开关。是否通过 veFaaS 的 VPC 共享 NAT 网关，访问公网。取值： true：开启，通过默认网卡访问公网。会产生公网出流量费用。 false：关闭，函数无法通过默认网卡访问公网。

NasStorage

参数	类型	示例值	描述
EnableNas	Boolean	false	是否开启 NAS 存储挂载。 true：开启，将数据存储至 NAS。 false：不开启。
NasConfigs	Array of NasConfig	-	NAS 存储配置。

参数

类型

示例值

描述

EnableNas

Boolean

false

是否开启 NAS 存储挂载。

true：开启，将数据存储至 NAS。
false：不开启。

NasConfigs

Array of NasConfig

NAS 存储配置。

TosMountConfig

参数	类型	示例值	描述
EnableTos	Boolean	false	是否开启 TOS 存储挂载。
Credentials	Object of Credentials	-	开启 TOS 后需要提供具有 TOS 域名访问权限的 AKSK。
MountPoints	Array of TosMountPoint	-	开启 TOS 后需要提供 TOS 存储配置列表，最多不超过 5 个。

HealthCheckConfig

参数	类型	示例值	描述
ProbeHandler	Object of ProbeHandler	HTTP	健康检查的类型：可以是 HTTP 或 TCP。
PeriodSeconds	Integer	10	每次健康检查之间的间隔时间（秒）。
TimeoutSeconds	Integer	2	每次健康检查的超时时间（秒）。
FailureThreshold	Integer	3	在判断探测失败之前需要连续失败的次数。
SuccessThreshold	Integer	3	在判断探测成功之前需要连续成功的次数。
EnableHealthCheck	Boolean	true	是否开启健康检查： true：开启。 false：关闭。
InitialDelaySeconds	Integer	5	首次健康检查前的延迟时间（秒）。

NasConfig

参数	类型	示例值	描述
Gid	Long	1000	文件系统中的用户组，暂时不支持自定义，如果提供该参数，参数值 1000（和函数 run user gid 保持一致）。
Uid	Long	1000	文件系统中的用户，暂时不支持自定义，如果提供该参数，参数值只能为 1000（和函数 run user uid 保持一致）。
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）。获取方式，请参见访问密钥使用指南。
SecretAccessKey	String	******	火山引擎账号的 Secret Access Key（SK）。获取方式，请参见访问密钥使用指南。

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	函数本地挂载目录。

ProbeHandler

参数	类型	示例值	描述
HTTPGet	Object of HTTPGetAction	-	使用 HTTP 协议进行存活探测。
TCPSocket	Object of TCPSocketAction	-	使用 TCP 协议进行存活探测。

HTTPGetAction

参数	类型	示例值	描述
Path	String	/hello	访问 HTTP 服务器的路径。
Port	Integer	8080	要访问的端口号或端口名称。数字必须在 1 到 65535 范围内。名称必须是 IANA_SVC_NAME。
Scheme	String	HTTP	用于连接主机的方案, HTTP, HTTPS 或 TCP。默认为 HTTP。
HTTPHeaders	Array of HTTPHeader	-	请求中设置的自定义头。HTTP 允许重复的头。

TCPSocketAction

参数	类型	示例值	描述
Port	Integer	8080	要访问的端口号或端口名称。数字必须在 1 到 65535 范围内。名称必须是 IANA_SVC_NAME。

HTTPHeader

参数	类型	示例值	描述
Name	String	Content-Type	HTTP Header 名称。
Value	String	application/json	HTTP Header 值。

返回示例

HTTP/1.1 200 OK
Content-Type: application/json
{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ListRevisions",
        "Version": "2024-06-06",
        "Service": "vefaas",
        "Region": "cn-beijing"
    },
    "Result": {
        "Items": [
            {
                "Id": "nw******",
                "Envs": [
                    {
                        "Key": "ENV_NAME",
                        "Value": "ENV_VALUE"
                    }
                ],
                "Name": "official-site",
                "Source": "templates/vefaas-python38-default.zip",
                "Runtime": "python3.8/v1",
                "CodeSize": 1024,
                "MemoryMB": 1024,
                "TlsConfig": {
                    "EnableLog": true,
                    "TlsProjectId": "a40202c5-fe22-4ea7-******",
                    "TlsTopicId": "2ff955cb-1f03-4b9b-******"
                },
                "VpcConfig": {
                    "EnableVpc": true,
                    "VpcId": "vpc-rrag******",
                    "SubnetIds": [
                        "subnet-milb******"
                    ],
                    "SecurityGroupIds": [
                        "sg-rrag******"
                    ],
                    "EnableSharedInternetAccess": true
                },
                "NasStorage": {
                    "EnableNas": true,
                    "NasConfigs": [
                        {
                            "FileSystemId": "cnas-cnb******",
                            "MountPointId": "mount-bce15678",
                            "RemotePath": "/",
                            "LocalMountPath": "/mnt/nas",
                            "Uid": 1000,
                            "Gid": 1000
                        }
                    ]
                },
                "SourceType": "tos",
                "Description": "This is a description",
                "MaxReplicas": 10,
                "CreationTime": "2020-05-20T13:00:55Z",
                "CodeSizeLimit": 64,
                "ExclusiveMode": true,
                "InitializerSec": 30,
                "MaxConcurrency": 100,
                "RequestTimeout": 30,
                "RevisionNumber": 1,
                "SourceLocation": "tos://tos-cn-beijing.volces.com/test.zip",
                "TosMountConfig": {
                    "EnableTos": true,
                    "MountPoints": [
                        {
                            "BucketPath": "/",
                            "LocalMountPath": "/mnt/tos",
                            "ReadOnly": false,
                            "BucketName": "ai-models",
                            "Endpoint": "http://tos-cn-beijing.ivolces.com"
                        }
                    ],
                    "Credentials": {
                        "AccessKeyId": "******",
                        "SecretAccessKey": "******"
                    }
                },
                "RevisionDescription": "This is a revision description",
                "RevisionCreationTime": "2020-05-20T13:00:55Z"
            }
        ],
        "Total": 1
    }
}

错误码

当前接口暂无独立错误码，若接口调用返回异常，可参考公共错误码进行故障排查。