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

文档中心

立即注册

导航

Release

最近更新时间：2024.09.24 19:03:21首次发布时间：2024.08.07 11:48:17

发布函数。

请求说明

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

调试

API Explorer

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

去调试

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	Release	接口名称。当前 API 的名称为 `Release`。
Version	String	是	2024-06-06	接口版本。当前 API 的版本为 `2024-06-06`。
FunctionId	String	是	nuvpugx5	函数 ID。
RevisionNumber	Integer	是	0	要发布的版本号, RevisionNumber = 0 时, 会发布最新的代码(Latest) 并创建新的版本。
TargetTrafficWeight	Integer	否	100	目标发布流量百分比，取值范围是 [0, 100]，代表希望发布的版本所占的流量比例, 值为 100 时代表全量发布。
RollingStep	Integer	否	100	灰度步长百分比，合法取值 1-100，默认 10。
Description	String	否	Support xxx feature	本次发布的描述信息。
MaxInstance	Integer	否	10	函数实例数上限。取值范围是 [0 ~ 账户剩余可用资源/单实例最大内存]。

请求示例

POST http://open.volcengineapi.com/?Action=Release&Version=2024-06-06 HTTP/1.1
Content-Type: application/json
{
    "FunctionId": "nuvpugx5",
    "RevisionNumber": 0,
    "TargetTrafficWeight": 100,
    "RollingStep": 100,
    "Description": "Support xxx feature",
    "MaxInstance": 10
}

返回参数

参数	类型	示例值	描述
FunctionId	String	nwwzoaq1	函数 ID。
Status	String	done	函数发布状态： pending：从未发布 inprogress：正在发布 done：发布成功 failed：发布失败
StatusMessage	String	Function release finished successfully	函数发布状态详细信息。作为发布状态的补充。
StableRevisionNumber	Integer	1	当前线上稳定运行的版本号码。初次发布成功后生成, 初次发布前 (status==pending) StableRevisionNumber 为 -1。
NewRevisionNumber	Integer	1	正在发布的新版本的版本号。在 status 为 pending 时不返回，为 inprogress/failed/done 时均返回。
OldRevisionNumber	Integer	1	旧版本的版本号。在 status 为 pending 时不返回，为 inprogress/failed/done 时均返回。
StartTime	String	2024-06-27 07:05:12	当前发布开始时间。status 为 pending 时不返回，为 inprogress/failed/done 时均返回。
TargetTrafficWeight	Integer	100	目标发布流量百分比。合法取值 0-100, 代表希望发布的版本所占的流量比例, 全量发布为 100。
CurrentTrafficWeight	Integer	50	当前发布流量当前百分比。合法取值 1-100, 代表当前正在发布的版本所占的流量比例, 只有 status 为 inprogress/failed 时返回。
ErrorCode	String	function_start_failed	发布失败时的错误码： function_start_failed：函数启动失败 function_start_timeout：函数启动超时 function_health_check_failed：函数健康检查失败 system_internal_error：系统内部错误
FailedInstanceLogs	String	https://vefaas-sit.tos-s3-cn-boe.volces.com/release_failed_instance_logs/r8ts3chz/xozoeiqdo91anhi9_coldstart	发布失败的实例日志下载链接。
ReleaseRecordId	String	xozoeiqdo91anhi9	发布记录 ID。

返回示例

HTTP/1.1 200 OK
Content-Type: application/json
{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "Release",
        "Version": "2024-06-06",
        "Service": "vefaas",
        "Region": "cn-beijing"
    },
    "Result": {
        "FunctionId": "nwwzoaq1",
        "Status": "done",
        "StatusMessage": "Function release finished successfully",
        "StableRevisionNumber": 1,
        "NewRevisionNumber": 1,
        "OldRevisionNumber": 1,
        "StartTime": "2024-06-27 07:05:12",
        "TargetTrafficWeight": 100,
        "CurrentTrafficWeight": 50,
        "ErrorCode": "function_start_failed",
        "FailedInstanceLogs": "https://vefaas-sit.tos-s3-cn-boe.volces.com/release_failed_instance_logs/r8ts3chz/xozoeiqdo91anhi9_coldstart",
        "ReleaseRecordId": "xozoeiqdo91anhi9"
    }
}

错误码

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