# 查询推理接入点滚动升级详情
> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。
`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetEndpointRolling&Version=2024-01-01`
查询指定滚动更新任务的详细信息，包括状态、灰度比例、滚动策略及执行日志。
## 鉴权
本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。
* Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 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`
滚动更新被回滚的时间，未回滚时为空
## 代码示例
## 默认
### cURL
#### Request
```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetEndpointRolling&Version=2024-01-01' \
-H 'Content-Type: application/json' \
-H 'X-Date: ' \
-H 'X-Content-Sha256: ' \
-H 'Authorization: HMAC-SHA256 Credential=//cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=' \
-d '{
"Id": "rolling-20240514212750-abc12"
}
'
```
#### Response
```
{
"ResponseMetadata": {
"RequestId": "20240514212756071829300ABCEF01B4",
"Action": "GetEndpointRolling",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"RollingInfo": {
"EndpointId": "ep-20260507230659-skvgn",
"Id": "rolling-20240514212750-abc12",
"Status": "Running",
"RollingIn": {
"Name": "doubao-seed-2-0-pro",
"ModelVersion": "260328",
"RouterInfo": {
"Strategy": "Balanced",
"Mode": "Automatic",
"CandidateModels": []
}
},
"RollingOut": {
"Name": "doubao-seed-2-0-pro",
"ModelVersion": "260215",
"RouterInfo": {
"Strategy": "Balanced",
"Mode": "Automatic",
"CandidateModels": []
}
},
"RollingGray": 0.4,
"CreateTime": "2024-05-14T21:27:50Z",
"UpdateTime": "2024-05-14T21:45:20Z",
"RollingStrategy": {
"Step": 20,
"WaitDuration": 300
},
"RollingTraceList": [
{
"CreateTime": "2024-05-14T21:27:50Z",
"Message": "滚动更新任务已创建，初始灰度比例 0%。"
},
{
"CreateTime": "2024-05-14T21:35:00Z",
"Message": "灰度比例递增至 20%。"
},
{
"CreateTime": "2024-05-14T21:45:20Z",
"Message": "灰度比例递增至 40%。"
}
],
"RevertTime": "",
"GrayWhenRevert": 0,
"InferenceDefaultParam": {
"ThinkingConfig": {
"Enabled": false
}
},
"Message": ""
}
}
}
```