您可以调用UpgradeClusterNodepool接口升级指定集群节点池的kubelet版本（建议与控制面版本一致）、操作系统版本或容器运行时版本。
接口说明
通过 UpgradeClusterNodepool 可升级指定集群节点池内节点的 Kubernetes 版本、操作系统版本或容器运行时版本。成功调用 UpgradeClusterNodepool 接口后，该 API 将返回此次升级任务的task_id，您可以通过调用任务 API 管理该操作任务：
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
cs:UpgradeClusterNodepool |
update |
*Cluster
|
无 | 无 |
请求语法
POST /clusters/{ClusterId}/nodepools/{NodepoolId}/upgrade HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClusterId |
string |
是 |
集群 ID。 |
c106f377e16f34eb1808d6b9362c9**** |
| NodepoolId |
string |
是 |
节点池 ID。 |
np31da1b38983f4511b490fc62108a**** |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求参数。 |
|
| image_id |
string |
否 |
节点系统镜像 ID。 |
aliyun_3_x64_20G_container_optimized_20241226.vhd |
| runtime_version |
string |
否 |
节点运行时版本。您可以调用 DescribeKubernetesVersionMetadata 在 runtime 中获取运行时版本信息。 |
1.6.36 |
| kubernetes_version |
string |
否 |
节点 Kubernetes 版本。您可以调用 DescribeKubernetesVersionMetadata 在 |
1.32.1-aliyun.1 |
| runtime_type |
string |
否 |
运行时类型。您可以调用 DescribeKubernetesVersionMetadata 在 runtime 中获取运行时信息。 |
containerd |
| use_replace |
boolean |
否 |
是否使用替盘升级。取值：
默认值：false。 |
false |
| rolling_policy |
object |
否 |
轮转配置。 |
|
| pause_policy |
string |
否 |
节点升级过程中的自动暂停策略。取值：
|
NotPause |
| batch_interval |
integer |
否 |
批次之间的升级间隔时间。该参数仅在暂停策略为 取值范围：[5,120]，单位：分钟。 该参数支持设置为 0，表示不设置间隔时间。 |
5 |
| max_parallelism |
integer |
否 |
节点池内的节点更新分批次执行，该参数定义每批次最大并行更新的节点数。 取值范围：[1,10]。 默认值：10。 |
2 |
| node_names |
array |
否 |
指定升级的节点列表。未指定时默认升级节点池内所有节点。 |
|
|
string |
否 |
节点名称，集群内节点标识。 |
cn-beijing.10.180.xx.xx |
|
| ignore_warning_check |
boolean |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
2D69A58F-345C-4FDE-88E4-BF518944**** |
| task_id |
string |
任务 ID。 |
T-5fd211e924e1d0078700**** |
示例
正常返回示例
JSON格式
{
"RequestId": "2D69A58F-345C-4FDE-88E4-BF518944****",
"task_id": "T-5fd211e924e1d0078700****"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。