POST https://ark.cn-beijing.volcengineapi.com/?Action=GetEndpointRolling&Version=2024-01-01
查询指定滚动更新任务的详细信息,包括状态、灰度比例、滚动策略及执行日志。
鉴权#
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。
- Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。
请求参数#
Body 参数#
Id string 必选 | 滚动更新任务 ID
要查询的滚动更新任务 ID
响应参数#
RollingInfo object | 滚动更新详情
滚动更新任务的详细信息
CreateTime string | 创建时间
RollingInfo.CreateTime
滚动更新任务的创建时间
EndpointId string | 接入点 ID
RollingInfo.EndpointId
滚动更新所属的推理接入点 ID
Id string | 滚动更新任务 ID
RollingInfo.Id
滚动更新任务的唯一标识
RollingGray number | 灰度比例
RollingInfo.RollingGray
当前滚动更新的灰度比例,取值范围 0~1
RollingIn object | 滚动入快照
RollingInfo.RollingIn
滚动更新的目标模型快照(即将切入的版本)
ModelVersion string | 模型版本
RollingInfo.RollingIn.ModelVersion
Name string | 模型名称
RollingInfo.RollingIn.Name
RouterInfo object | 路由信息
RollingInfo.RollingIn.RouterInfo
该快照对应的智能路由配置
Mode string | 路由模式
RollingInfo.RollingIn.RouterInfo.Mode
路由模式。取值 Automatic(自动)、CandidateSet(候选集合)、Ordered(按顺序)
Strategy string | 路由策略
RollingInfo.RollingIn.RouterInfo.Strategy
路由策略。取值 EffectFirst(效果优先)、CostFirst(成本优先)、Balanced(均衡)
CandidateModels object[] | 候选模型列表
RollingInfo.RollingIn.RouterInfo.CandidateModels
CustomModelId string | 定制模型的 ID
RollingInfo.RollingIn.RouterInfo.CandidateModels.CustomModelId
FoundationModel object | 基础模型引用
RollingInfo.RollingIn.RouterInfo.CandidateModels.FoundationModel
ModelVersion string | 基础模型版本
RollingInfo.RollingIn.RouterInfo.CandidateModels.FoundationModel.ModelVersion
Name string | 基础模型名称
RollingInfo.RollingIn.RouterInfo.CandidateModels.FoundationModel.Name
RollingOut object | 滚动出快照
RollingInfo.RollingOut
滚动更新的原始模型快照(即将切出的版本)
ModelVersion string | 模型版本
RollingInfo.RollingOut.ModelVersion
Name string | 模型名称
RollingInfo.RollingOut.Name
RouterInfo object | 路由信息
RollingInfo.RollingOut.RouterInfo
该快照对应的智能路由配置
Mode string | 路由模式
RollingInfo.RollingOut.RouterInfo.Mode
路由模式。取值 Automatic(自动)、CandidateSet(候选集合)、Ordered(按顺序)
Strategy string | 路由策略
RollingInfo.RollingOut.RouterInfo.Strategy
路由策略。取值 EffectFirst(效果优先)、CostFirst(成本优先)、Balanced(均衡)
CandidateModels object[] | 候选模型列表
RollingInfo.RollingOut.RouterInfo.CandidateModels
CustomModelId string | 定制模型的 ID
RollingInfo.RollingOut.RouterInfo.CandidateModels.CustomModelId
FoundationModel object | 基础模型引用
RollingInfo.RollingOut.RouterInfo.CandidateModels.FoundationModel
ModelVersion string | 基础模型版本
RollingInfo.RollingOut.RouterInfo.CandidateModels.FoundationModel.ModelVersion
Name string | 基础模型名称
RollingInfo.RollingOut.RouterInfo.CandidateModels.FoundationModel.Name
RollingStrategy object | 滚动策略
RollingInfo.RollingStrategy
滚动更新的执行策略配置
Step integer | 灰度步长
RollingInfo.RollingStrategy.Step
每次灰度递增的步长百分比
WaitDuration integer | 等待时长
RollingInfo.RollingStrategy.WaitDuration
每次灰度递增后的观察等待时长(秒)
RollingTraceList object[] | 执行日志列表
RollingInfo.RollingTraceList
滚动更新的执行日志列表,记录每次灰度变更
CreateTime string | 日志时间
RollingInfo.RollingTraceList.CreateTime
该日志记录的创建时间
Message string | 日志消息
RollingInfo.RollingTraceList.Message
该日志记录的详细消息内容
Status string | 任务状态
RollingInfo.Status
滚动更新任务的当前状态
UpdateTime string | 更新时间
RollingInfo.UpdateTime
滚动更新任务的最近更新时间
GrayWhenRevert number | 回滚时灰度比例
RollingInfo.GrayWhenRevert
执行回滚时的灰度比例
InferenceDefaultParam object | 推理默认参数
RollingInfo.InferenceDefaultParam
推理默认参数配置
ThinkingConfig object | Thinking 配置
RollingInfo.InferenceDefaultParam.ThinkingConfig
Enabled boolean | 是否启用 Thinking
RollingInfo.InferenceDefaultParam.ThinkingConfig.Enabled
是否启用 Thinking 能力
Message string | 附加消息
RollingInfo.Message
滚动更新任务的附加消息,如失败原因等
RevertTime string | 回滚时间
RollingInfo.RevertTime
滚动更新被回滚的时间,未回滚时为空