面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/get-endpoint-rolling-api.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

查询推理接入点滚动升级详情

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

滚动更新被回滚的时间,未回滚时为空