更新函数发布 (更新发布流量占比)。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateRelease | 接口名称。当前 API 的名称为 UpdateRelease 。 |
Version | String | 是 | 2024-06-06 | 接口版本。当前 API 的版本为 2024-06-06 。 |
FunctionId | String | 是 | nwwzoaq1 | 函数 ID。 |
TargetTrafficWeight | Integer | 是 | 50 | 目标发布流量百分比。合法取值 0-100, 代表希望发布的版本所占的流量比例。 |
POST http://open.volcengineapi.com/?Action=UpdateRelease&Version=2024-06-06 HTTP/1.1 Content-Type: application/json { "FunctionId": "nwwzoaq1", "TargetTrafficWeight": 50 }
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
FunctionId | String | nwwzoaq1 | 函数 ID。 |
Status | String | done | 函数发布状态:
|
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 | 发布失败时的错误码:
|
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": "UpdateRelease", "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" } }
当前接口暂无独立错误码,若接口调用返回异常,可参考 公共错误码 进行故障排查。