查看服务更新计划
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /api/v2/services/{ClusterId}/{ServiceName}/rollout HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClusterId |
string |
否 |
服务所在地域 ID。 |
cn-shanghai |
| ServiceName |
string |
否 |
服务名。 |
foo |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
当前API无需请求参数
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应 Body。 |
||
| RequestId |
string |
请求 ID。每次请求返回的唯一标识，用于问题排查和追踪。 |
40325405-579C-4D82**** |
| Rollout |
object |
发布策略信息。包含策略配置（Strategy）和执行状态（Status）。 |
|
| Strategy |
object |
发布策略配置。包含分区或批量发布的具体配置参数。 |
|
| Partition |
object |
分区发布配置。如果使用分区发布策略，则返回此项；否则不返回。 |
|
| Partition |
string |
分区值。表示保留的旧副本数量或百分比。例如 '50%' 表示保留 50%的旧副本。 |
50% |
| Batch |
object |
批量发布配置。如果使用批量发布策略，则返回此项；否则不返回。 |
|
| BatchSize |
string |
批次大小。每批次更新的副本数量或百分比。 |
1 |
| Interval |
string |
批次间隔。两次发布之间的等待时间。 |
5m |
| Status |
object |
发布策略执行状态。包含当前发布进度和阶段信息。 |
|
| Phase |
string |
发布阶段。可能值：
|
Running |
| TotalReplicas |
integer |
总副本数。服务的总副本数量。 |
10 |
| UpdatedReplicas |
integer |
已更新副本数。已完成更新到新版本的副本数量。 |
5 |
| CurrentRevision |
string |
当前版本。当前正在运行的版本标识。 |
service-abc123-v1 |
| UpdateRevision |
string |
更新版本。正在更新到的目标版本标识。 |
service-abc123-v2 |
| NextBatchStartTime |
string |
下一批开始更新的时间。 |
2026/05/08 16:10:56 |
示例
正常返回示例
JSON格式
{
"RequestId": "40325405-579C-4D82****",
"Rollout": {
"Strategy": {
"Partition": {
"Partition": "50%"
},
"Batch": {
"BatchSize": "1",
"Interval": "5m"
}
},
"Status": {
"Phase": "Running",
"TotalReplicas": 10,
"UpdatedReplicas": 5,
"CurrentRevision": "service-abc123-v1",
"UpdateRevision": "service-abc123-v2",
"NextBatchStartTime": "2026/05/08 16:10:56"
}
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。