查询函数的指定版本

功能介绍

该 API 用于在 openYuanrong 集群，调用 meta_service 接口查询函数。

接口约束

无

URI

GET /serverless/v1/functions/{name}?versionNumber={version}

路径参数

名称	类型	是否必填	描述
name	String	是	函数名称。

查询参数

名称	类型	是否必填	描述
version	String	是	版本名称，精准匹配。

请求参数

请求 Header 参数

无

请求 Body 参数

无

响应参数

名称	类型	是否必填	描述
code	int	是	返回码，0 表示查询成功，非 0 查询失败，，更多信息参考错误码。
message	String	是	返回错误信息。
function	GetFunctionResult	是	创建结果。

GetFunctionResult Object

名称	类型	是否必填	描述
id	int	是	函数 ID。
functionVersionUrn	String	是	函数版本 URN, 用于调用函数。
revisionId	String	是	函数 revisionId， 用于发布函数。
name	String	是	函数名称。
createTime	Date	是	函数创建时间。
updateTime	Date	是	函数更新时间。
versionNumber	String	是	版本号。
runtime	String	是
description	String	否	函数描述。
handler	String	是	call handler。
cpu	int	是	函数 CPU 大小，单位：m（毫核）。
memory	int	是	函数 MEM 大小，单位：MB。
timeout	int	是
customResources	map	否	函数自定义资源。 约束：key-value 格式，key 为 string， value 为 float 类型。
environment	map	否	函数环境变量。 约束：key-value 格式，key 和 value 均为 string。
minInstance	int	否	最小实例数（函数服务使用）。
maxInstance	int	否	最大实例数（函数服务使用）。
concurrentNum	int	否	实例并发度（函数服务使用）。
storageType	String	是	代码包存储类型。 取值：local、s3。
codePath	String	否	代码包本地路径，storageType 配置为 local 时生效。
bucketId	String	否	存储桶名。
objectId	String	否	存储对象 ID。

状态码

状态码	描述
200	请求成功（ok）。
400	错误的请求（Bad Request）。
500	内部服务器错误（Internal Server Error）。

请求示例

curl -X GET http://x.x.x.x:31182/serverless/v1/functions/0-f-a?versionNumber=v20240508-154704

响应示例

正常响应

{
    "code": 0,
    "message": "SUCCESS",
    "function": {
        "id": "sn:cn:yrk:default:function:0-f-a:v20240508-154704",
        "createTime": "2024-05-09 02:25:49.477 UTC",
        "updateTime": "",
        "functionUrn": "sn:cn:yrk:default:function:0-f-a",
        "name": "0-f-a",
        "tenantId": "default",
        "businessId": "yrk",
        "productId": "",
        "reversedConcurrency": 0,
        "description": "this is func",
        "tag": null,
        "functionVersionUrn": "sn:cn:yrk:default:function:0-f-a:v20240508-154704",
        "revisionId": "20240509022549477",
        "codeSize": 3753,
        "codeSha256": "39267d6c674f7ae5f99a284323d1f7f036b68e055e55f23a1fdcaa14c6e267e0",
        "bucketId": "bucket-test-log1",
        "objectId": "a-1715221549479",
        "handler": "",
        "layers": null,
        "cpu": 500,
        "memory": 500,
        "runtime": "cpp11",
        "timeout": 500,
        "versionNumber": "v20240508-154704",
        "versionDesc": "try-mod-version2",
        "environment": {},
        "customResources": {},
        "statefulFlag": 0,
        "lastModified": "2024-05-09 02:25:49.477 UTC",
        "Published": "2024-05-09 02:25:49.536 UTC",
        "minInstance": 0,
        "maxInstance": 100,
        "concurrentNum": 100,
        "funcLayer": null,
        "status": "unavailable",
        "instanceNum": 0,
        "device": {},
        "created": "2024-05-09 02:25:49.477 UTC"
    }
}

错误响应

{
    "code":4115,
    "message":"function [a] is not found. check input parameters"
}